receive_serialized_itemT_receive_serialized_itemReceiveSerializedItemReceiveSerializedItem (Operator)

Name

receive_serialized_itemT_receive_serialized_itemReceiveSerializedItemReceiveSerializedItem — Receive a serialized item over a socket connection.

Signature

receive_serialized_item( : : Socket : SerializedItemHandle)

Herror T_receive_serialized_item(const Htuple Socket, Htuple* SerializedItemHandle)

void ReceiveSerializedItem(const HTuple& Socket, HTuple* SerializedItemHandle)

HSerializedItem HSocket::ReceiveSerializedItem() const

void HSerializedItem::ReceiveSerializedItem(const HSocket& Socket)

static void HOperatorSet.ReceiveSerializedItem(HTuple socket, out HTuple serializedItemHandle)

HSerializedItem HSocket.ReceiveSerializedItem()

void HSerializedItem.ReceiveSerializedItem(HSocket socket)

Description

receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem receives a serialized item that was sent over the socket connection determined by SocketSocketSocketSocketsocket of another HALCON process using the operator send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem for an introduction of the basics of serialization). If no serialized item has been sent, the HALCON process calling receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem 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 SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. For a detailed example showing the use of a socket connection, see open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAccept.

Execution Information

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

SocketSocketSocketSocketsocket (input_control)  socket HSocket, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Socket number.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (output_control)  serialized_item HSerializedItem, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

Result

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

Possible Predecessors

send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem

Possible Successors

get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtr, deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrix, deserialize_metrology_modeldeserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModelDeserializeMetrologyModel

Module

Foundation