Operator Reference

HALCON Operator Reference / System / Serialized Item

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item (Operator)

clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item — Delete a serialized item.

Signature

clear_serialized_item( : : SerializedItemHandle : )

Herror T_clear_serialized_item(const Htuple SerializedItemHandle)

void ClearSerializedItem(const HTuple& SerializedItemHandle)

static void HSerializedItem::ClearSerializedItem(const HSerializedItemArray& SerializedItemHandle)

void HSerializedItem::ClearSerializedItem() const

static void HOperatorSet.ClearSerializedItem(HTuple serializedItemHandle)

static void HSerializedItem.ClearSerializedItem(HSerializedItem[] serializedItemHandle)

void HSerializedItem.ClearSerializedItem()

def clear_serialized_item(serialized_item_handle: MaybeSequence[HHandle]) -> None

Description

clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item deletes a serialized item, which is passed by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basics of serialization). If a serialized item is created only by a data pointer, it will not be deleted. Such a data pointer, that points to the beginning of serialized item can be created by the operator get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr. After calling clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item, the handle of the serialized item becomes invalid.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

This operator modifies the state of the following input parameter:

• SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control, state is modified)  serialized_item(-array) → HSerializedItem, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

Result

If the parameters are valid, the operator clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Possible Predecessors

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item

Module

Foundation

---

ClassesClasses | | Operators