receive_tupleT_receive_tupleReceiveTupleReceiveTuplereceive_tuple (Operator)

Name

receive_tupleT_receive_tupleReceiveTupleReceiveTuplereceive_tuple — Receive a tuple over a socket connection.

Signature

receive_tuple( : : Socket : Tuple)

Herror T_receive_tuple(const Htuple Socket, Htuple* Tuple)

void ReceiveTuple(const HTuple& Socket, HTuple* Tuple)

HTuple HSocket::ReceiveTuple() const

static void HOperatorSet.ReceiveTuple(HTuple socket, out HTuple tuple)

HTuple HSocket.ReceiveTuple()

def receive_tuple(socket: HHandle) -> Union[float, int, str]

Description

receive_tuplereceive_tupleReceiveTupleReceiveTupleReceiveTuplereceive_tuple reads a TupleTupleTupleTupletupletuple that was sent over the socket connection determined by SocketSocketSocketSocketsocketsocket by another HALCON process using the operator send_tuplesend_tupleSendTupleSendTupleSendTuplesend_tuple. If no tuple has been sent, the HALCON process calling receive_tuplereceive_tupleReceiveTupleReceiveTupleReceiveTuplereceive_tuple blocks until enough data arrives. For a detailed example, see open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAcceptopen_socket_accept.

Attention

receive_tuplereceive_tupleReceiveTupleReceiveTupleReceiveTuplereceive_tuple does not allow receiving tuples containing HALCON handles.

Execution Information

Parameters

SocketSocketSocketSocketsocketsocket (input_control)  socket HSocket, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Socket number.

TupleTupleTupleTupletupletuple (output_control)  string HTupleUnion[float, int, str]HTupleHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong)

Received tuple.

Possible Predecessors

open_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnectOpenSocketConnectopen_socket_connect, socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect, get_socket_paramget_socket_paramGetSocketParamGetSocketParamGetSocketParamget_socket_param, set_socket_paramset_socket_paramSetSocketParamSetSocketParamSetSocketParamset_socket_param

See also

send_tuplesend_tupleSendTupleSendTupleSendTuplesend_tuple, send_imagesend_imageSendImageSendImageSendImagesend_image, receive_imagereceive_imageReceiveImageReceiveImageReceiveImagereceive_image, send_regionsend_regionSendRegionSendRegionSendRegionsend_region, receive_regionreceive_regionReceiveRegionReceiveRegionReceiveRegionreceive_region, get_next_socket_data_typeget_next_socket_data_typeGetNextSocketDataTypeGetNextSocketDataTypeGetNextSocketDataTypeget_next_socket_data_type

Module

Foundation