create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtr (Operator)
Name
create_serialized_item_ptrT_create_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtr
— Anlegen eines serialisierten Elements.
Warnung
Es wird nicht empfolen, den Operator
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtr
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)
Beschreibung
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtr
legt ein serialisiertes Element an,
und gibt dessen Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle
zurück (siehe
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem
für eine Einführung in die Grundlagen
der Serialisierung). Mit dem
Parameter PointerPointerPointerPointerpointer
wird der Datenzeiger, d.h. der Anfang
des serialisierten Elements, übergeben. Mit dem Parameter SizeSizeSizeSizesize
wird die Größe des serialisierten Elements in Byte übergeben. Mit dem
Parameter CopyCopyCopyCopycopy
wird das Verhalten des Operators gesteuert.
Falls CopyCopyCopyCopycopy
auf den Wert 'true'"true""true""true""true" gesetzt ist, wird
ein neues serialisiertes Element erzeugt und die Werte des
vorhandenen serialisierten Elements kopiert. Falls CopyCopyCopyCopycopy
auf
den Wert '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 CopyCopyCopyCopycopy
auf den Wert '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
PointerPointerPointerPointerpointer
(input_control) pointer →
HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Datenzeiger auf ein serialisiertes Element.
SizeSizeSizeSizesize
(input_control) integer →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Größe des serialisierten Elements.
CopyCopyCopyCopycopy
(input_control) string →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Kopiermodus des serialisierten Elements.
Defaultwert:
'true'
"true"
"true"
"true"
"true"
Werteliste: 'false'"false""false""false""false", 'true'"true""true""true""true"
SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle
(output_control) serialized_item →
HSerializedItem, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des serialisierten Elements.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtr
den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtr
Modul
Foundation