create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr (Operator)
Name
create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr — Anlegen eines serialisierten Elements.
Warnung
Es wird nicht empfohlen, den Operator
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr in HDevelop zu verwenden.
Signatur
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)
(Nur Windows)
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)
(Nur Windows)
def create_serialized_item_ptr(pointer: int, size: int, copy: str) -> HHandle
Beschreibung
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr legt ein serialisiertes Element an,
und gibt dessen Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle zurück (siehe
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item für eine Einführung in die Grundlagen
der Serialisierung). Mit dem
Parameter PointerPointerPointerPointerpointerpointer wird der Datenzeiger, d.h. der Anfang
des serialisierten Elements, übergeben. Mit dem Parameter SizeSizeSizeSizesizesize
wird die Größe des serialisierten Elements in Byte übergeben. Mit dem
Parameter CopyCopyCopyCopycopycopy wird das Verhalten des Operators gesteuert.
Falls CopyCopyCopyCopycopycopy auf den Wert 'true'"true""true""true""true""true" gesetzt ist, wird
ein neues serialisiertes Element erzeugt und die Werte des
vorhandenen serialisierten Elements kopiert. Falls CopyCopyCopyCopycopycopy auf
den Wert 'false'"false""false""false""false""false" gesetzt ist, wird nur der Datenzeiger des
übergebenen serialisierten Elements gespeichert ohne die Daten in ein
neues serialisiertes Element zu kopieren. In diesem Fall erhöht sich
die Geschwindigkeit des Operators.
Achtung
Falls der Parameter CopyCopyCopyCopycopycopy auf den Wert 'false'"false""false""false""false""false"
gesetzt ist, darf der zum Datenzeiger des serialisierten Elements
gehörende Speicher während der Nutzung des neuen serialisierten
Elements nicht gelöscht werden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Parameter
PointerPointerPointerPointerpointerpointer (input_control) pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Datenzeiger auf ein serialisiertes Element.
SizeSizeSizeSizesizesize (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Größe des serialisierten Elements.
CopyCopyCopyCopycopycopy (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Kopiermodus des serialisierten Elements.
Defaultwert:
'true'
"true"
"true"
"true"
"true"
"true"
Werteliste: '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 des serialisierten Elements.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr
Modul
Foundation