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
Description
send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item sends a serialized item over a socket
connection determined by SocketSocketSocketsocketsocket (see
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the
basics of serialization). The receiving HALCON process must
call receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item to read the serialized item
from the socket. The serialized item is returned by the handle
SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle.
For a detailed example showing the use of a socket connection, see
open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptopen_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
SocketSocketSocketsocketsocket (input_control) socket → HSocket, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Socket number.
SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the serialized item.
Result
If the parameters are valid, the operator
send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item returns the value 2 (
H_MSG_TRUE)
. If
necessary, an exception is raised.
Possible Predecessors
create_serialized_item_ptrcreate_serialized_item_ptrCreateSerializedItemPtrCreateSerializedItemPtrcreate_serialized_item_ptr,
serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixserialize_matrix,
serialize_metrology_modelserialize_metrology_modelSerializeMetrologyModelSerializeMetrologyModelserialize_metrology_model
Possible Successors
receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item
Module
Foundation