Skip to content

send_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_itemT_send_serialized_item🔗

Short description🔗

send_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_itemT_send_serialized_item — Send a serialized item over a socket connection.

Signature🔗

send_serialized_item( socket Socket, serialized_item SerializedItemHandle )void SendSerializedItem( const HTuple& Socket, const HTuple& SerializedItemHandle )static void HOperatorSet.SendSerializedItem( HTuple socket, HTuple serializedItemHandle )def send_serialized_item( socket: HHandle, serialized_item_handle: HHandle ) -> None

Herror T_send_serialized_item( const Htuple Socket, const Htuple SerializedItemHandle )

void HSocket::SendSerializedItem( const HSerializedItem& SerializedItemHandle ) const

void HSerializedItem::SendSerializedItem( const HSocket& Socket ) const

void HSocket.SendSerializedItem( HSerializedItem serializedItemHandle )

void HSerializedItem.SendSerializedItem( HSocket socket )

Description🔗

send_serialized_itemSendSerializedItem sends a serialized item over a socket connection determined by Socketsocketsocket (see fwrite_serialized_itemFwriteSerializedItem for an introduction of the basics of serialization). The receiving HALCON process must call receive_serialized_itemReceiveSerializedItem to read the serialized item from the socket. The serialized item is returned by the handle SerializedItemHandleserializedItemHandleserialized_item_handle. For a detailed example showing the use of a socket connection, see open_socket_acceptOpenSocketAccept.

Execution information🔗

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🔗

Socketsocketsocket (input_control) socket → (handle)HTuple (HHandle)HSocket, HTuple (IntPtr)HHandleHtuple (handle)

Socket number.

SerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)HTuple (HHandle)HSerializedItem, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the serialized item.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

create_serialized_item_ptrCreateSerializedItemPtr, serialize_matrixSerializeMatrix, serialize_metrology_modelSerializeMetrologyModel

Possible successors

receive_serialized_itemReceiveSerializedItem

Module🔗

Foundation