clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItem (Operator)

Name

clear_serialized_itemclear_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.

Parameter

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control) serialized_item(-array) → (integer)

Handle des serialisierten Elements.

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