create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr (Operator)

Name

create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr — Create a serialized item.

Warning

It is not recommended to use the operator create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr in HDevelop.

Signature

create_serialized_item_ptr( : : Pointer, Size, Copy : SerializedItemHandle)

Herror T_create_serialized_item_ptr(const Htuple Pointer, const Htuple Size, const Htuple Copy, Htuple* SerializedItemHandle)

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)

static void HOperatorSet.CreateSerializedItemPtr(HTuple pointer, HTuple size, HTuple copy, out HTuple serializedItemHandle)

public HSerializedItem(IntPtr pointer, int size, string copy)

void HSerializedItem.CreateSerializedItemPtr(IntPtr pointer, int size, string copy)

def create_serialized_item_ptr(pointer: int, size: int, copy: str) -> HHandle

Description

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.

Attention

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.

Execution Information

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.

Parameters

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.

Default value: 'true' "true" "true" "true" "true" "true"

List of values: '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.

Result

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.

Possible Successors

get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr

Module

Foundation