clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItem (Operator)

Name

clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItem — Löschen eines serialisierten Elements.

Signatur

clear_serialized_item( : : SerializedItemHandle : )

Beschreibung

clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemClearSerializedItem löscht ein serialisiertes Element, welches in dem Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle übergeben wird (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem für eine Einführung in die Grundlagen der Serialisierung). Nicht gelöscht wird ein serialisiertes Element, welches nur mittels eines Datenzeigers angelegt wurde. Erzeugt wird ein solcher Datenzeiger, der auf den Anfang eines serialisierten Elements zeigt, mit dem Operator get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtr. Nach dem Aufruf ist das Handle des serialisierte Elements ungültig.

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 modifiziert den Zustand des folgenden Eingabeparameters:

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle

Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.

Parameter

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control, Zustand wird modifiziert) serialized_item(-array) → (handle)

Handle des serialisierten Elements.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemClearSerializedItem den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem

Modul

Foundation

Operatoren