Skip to content

receive_tupleReceiveTupleReceiveTuplereceive_tupleT_receive_tuple🔗

Short description🔗

receive_tupleReceiveTupleReceiveTuplereceive_tupleT_receive_tuple — Receive a tuple over a socket connection.

Signature🔗

receive_tuple( socket Socket, out string Tuple )void ReceiveTuple( const HTuple& Socket, HTuple* Tuple )static void HOperatorSet.ReceiveTuple( HTuple socket, out HTuple tuple )def receive_tuple( socket: HHandle ) -> Union[float, int, str]

Herror T_receive_tuple( const Htuple Socket, Htuple* Tuple )

HTuple HSocket::ReceiveTuple( ) const

HTuple HSocket.ReceiveTuple( )

Description🔗

receive_tupleReceiveTuple reads a Tupletupletuple that was sent over the socket connection determined by Socketsocketsocket by another HALCON process using the operator send_tupleSendTuple. If no tuple has been sent, the HALCON process calling receive_tupleReceiveTuple blocks until enough data arrives. For a detailed example, see open_socket_acceptOpenSocketAccept.

Attention🔗

receive_tupleReceiveTuple does not allow receiving tuples containing HALCON handles.

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.

Tupletupletuple (output_control) string → (string / real / integer)HTuple (HString / double / Hlong)HTuple (string / double / int / long)Union[float, int, str]Htuple (char* / double / Hlong)

Received tuple.

Combinations with other operators🔗

Combinations

Possible predecessors

open_socket_connectOpenSocketConnect, socket_accept_connectSocketAcceptConnect, get_socket_paramGetSocketParam, set_socket_paramSetSocketParam

See also

send_tupleSendTuple, send_imageSendImage, receive_imageReceiveImage, send_regionSendRegion, receive_regionReceiveRegion, get_next_socket_data_typeGetNextSocketDataType

Module🔗

Foundation