create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr创建序列化项指针（算子）
名称
create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr — 创建序列化项。
警告
不建议在 HDevelop 中使用
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr 算子。
签名
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 用于创建一个序列化项，并返回句柄 SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle （有关序列化基础知识的介绍，请参阅
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item）。数据指针（即序列化项的起始位置）通过参数 PointerPointerPointerPointerpointerpointer 传递。序列化项的字节大小通过参数
SizeSizeSizeSizesizesize 传递。该算子的行为由参数 CopyCopyCopyCopycopycopy 控制。若 CopyCopyCopyCopycopycopy 设置为 'true'"true""true""true""true""true"，则创建一个新的序列化项，并将现有序列化项的值复制进去。若 CopyCopyCopyCopycopycopy 设置为
'false'"false""false""false""false""false"，则仅存储输入序列化项的数据指针，即不复制实际数据，从而缩短执行时间。
注意
如果参数 CopyCopyCopyCopycopycopy 设置为 'false'"false""false""false""false""false"，在使用新序列化项期间，不得删除该序列化项的数据指针。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
此算子返回一个句柄。请注意，即使该句柄被用作特定算子的输入参数，这些算子仍可能改变此句柄类型的实例状态。
参数
PointerPointerPointerPointerpointerpointer (输入控制) pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
序列化项的数据指针。
SizeSizeSizeSizesizesize (输入控制) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
序列化项的大小。
CopyCopyCopyCopycopycopy (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
序列化项的复制模式。
默认值：
'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)
序列化项的句柄。
结果
如果参数有效，算子
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr 返回值 2 (H_MSG_TRUE)。如有必要，则抛出异常。
可能的后继
get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr
模块
基础