send_serialized_itemT_send_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item (Operator)

Name

send_serialized_itemT_send_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item — Send a serialized item over a socket connection.

Signature

send_serialized_item( : : Socket, SerializedItemHandle : )

Description

send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item sends a serialized item over a socket connection determined by SocketSocketSocketSocketsocketsocket (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basics of serialization). The receiving HALCON process must call receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item to read the serialized item from the socket. The serialized item is returned by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. For a detailed example showing the use of a socket connection, see open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAcceptopen_socket_accept.

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

SocketSocketSocketSocketsocketsocket (input_control) socket → (handle)

Socket number.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)

Handle of the serialized item.

Result

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

Possible Predecessors

create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr, serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrixserialize_matrix, serialize_metrology_modelserialize_metrology_modelSerializeMetrologyModelSerializeMetrologyModelSerializeMetrologyModelserialize_metrology_model

Possible Successors

receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item

Module

Foundation

Operators