create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr (Operator)
名称
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.
执行信息
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
参数
PointerPointerPointerPointerpointerpointer (input_control) pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Data pointer of the serialized item.
SizeSizeSizeSizesizesize (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Size of the serialized item.
CopyCopyCopyCopycopycopy (input_control) 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 (output_control) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the serialized item.
结果
If the parameters are valid, the operator
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
可能的后继算子
get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr
模块
Foundation