send_serialized_itemT_send_serialized_itemSendSerializedItemSendSerializedItem (Operator)

Name

send_serialized_itemT_send_serialized_itemSendSerializedItemSendSerializedItem — Send a serialized item over a socket connection.

Signature

send_serialized_item( : : Socket, SerializedItemHandle : )

Description

send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem sends a serialized item over a socket connection determined by SocketSocketSocketSocketsocket (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem for an introduction of the basics of serialization). The receiving HALCON process must call receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem to read the serialized item from the socket. The serialized item is returned by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. For a detailed example showing the use of a socket connection, see open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAccept.

Execution Information

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

Parameters

SocketSocketSocketSocketsocket (input_control) socket → (handle)

Socket number.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control) serialized_item → (handle)

Handle of the serialized item.

Result

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

Possible Predecessors

create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtr, serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrix, serialize_metrology_modelserialize_metrology_modelSerializeMetrologyModelSerializeMetrologyModelSerializeMetrologyModel

Possible Successors

receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem

Module

Foundation

Operators