create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr (算子)
名称
create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr — 创建序列化项。
警告
It is not recommended to use the operator
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr in HDevelop.
签名
void CreateSerializedItemPtr(const HTuple& Pointer, const HTuple& Size, const HTuple& Copy, HTuple* SerializedItemHandle)
void HSerializedItem::HSerializedItem(void* Pointer, Hlong Size, const HString& Copy)
void HSerializedItem::HSerializedItem(void* Pointer, Hlong Size, const char* Copy)
void HSerializedItem::HSerializedItem(void* Pointer, Hlong Size, const wchar_t* Copy)
(
Windows only)
void HSerializedItem::CreateSerializedItemPtr(void* Pointer, Hlong Size, const HString& Copy)
void HSerializedItem::CreateSerializedItemPtr(void* Pointer, Hlong Size, const char* Copy)
void HSerializedItem::CreateSerializedItemPtr(void* Pointer, Hlong Size, const wchar_t* Copy)
(
Windows only)
def create_serialized_item_ptr(pointer: int, size: int, copy: str) -> HHandle
描述
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr creates a serialized item
and returns the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (see
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basics of
serialization). The data pointer, i.e., the beginning of the
serialized item, is passed by the parameter PointerPointerPointerPointerpointerpointer.
The size of the serialized item in bytes is passed by parameter
SizeSizeSizeSizesizesize. The behavior of the operator is controlled by the
parameter CopyCopyCopyCopycopycopy. If CopyCopyCopyCopycopycopy is set to 'true'"true""true""true""true""true",
a new serialized item is created and the values of the existing
serialized item are copied. If CopyCopyCopyCopycopycopy is set to
'false'"false""false""false""false""false", only the data pointer of the input serialized item
is stored, i.e., the actual data are not copied, which leads to shorter
execution times.
注意
If the parameter CopyCopyCopyCopycopycopy is set to 'false'"false""false""false""false""false", the data
pointer of the serialized item must not be deleted during using the
new serialized item.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
此算子返回一个句柄。请注意，即使该句柄被用作特定算子的输入参数，这些算子仍可能改变此句柄类型的实例状态。
参数
PointerPointerPointerPointerpointerpointer (输入控制) pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Data pointer of the serialized item.
SizeSizeSizeSizesizesize (输入控制) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Size of the serialized item.
CopyCopyCopyCopycopycopy (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Copy mode of the serialized item.
默认值：
'true'
"true"
"true"
"true"
"true"
"true"
值列表：
'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (输出控制) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the serialized item.
结果
如果参数有效，算子
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。
可能的后继
get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr
模块
基础