clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item (Operator)

Name

clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item — Löschen eines serialisierten Elements.

Signatur

clear_serialized_item( : : SerializedItemHandle : )

Beschreibung

clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemClearSerializedItemclear_serialized_item löscht ein serialisiertes Element, welches in dem Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle übergeben wird (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item 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_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr. 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:

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle

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

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

Handle des serialisierten Elements.

Ergebnis

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

Vorgänger

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item

Modul

Foundation

Operatoren