receive_serialized_itemreceive_serialized_itemReceiveSerializedItemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItem (Operator)

Name

receive_serialized_itemreceive_serialized_itemReceiveSerializedItemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItem — Receive a serialized item over a socket connection.

Signature

Description

receive_serialized_itemreceive_serialized_itemReceiveSerializedItemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItem receives a serialized item that was sent over the socket connection determined by SocketSocketSocketSocketSocketsocket of another HALCON process using the operator send_serialized_itemsend_serialized_itemSendSerializedItemsend_serialized_itemSendSerializedItemSendSerializedItem (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem for an introduction of the basics of serialization). If no serialized item has been sent, the HALCON process calling receive_serialized_itemreceive_serialized_itemReceiveSerializedItemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItem blocks until enough data arrives. The data is stored in a new created serialized item. The operator returns the handle of the serialized item in parameter SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. For a detailed example showing the use of a socket connection, see open_socket_acceptopen_socket_acceptOpenSocketAcceptopen_socket_acceptOpenSocketAcceptOpenSocketAccept.

Parallelization

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

Parameters

Result

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

Possible Predecessors

send_serialized_itemsend_serialized_itemSendSerializedItemsend_serialized_itemSendSerializedItemSendSerializedItem

Possible Successors

get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtr, deserialize_matrixdeserialize_matrixDeserializeMatrixdeserialize_matrixDeserializeMatrixDeserializeMatrix, deserialize_metrology_modeldeserialize_metrology_modelDeserializeMetrologyModeldeserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModel

Module

Foundation