receive_tupleT_receive_tupleReceiveTupleReceiveTuplereceive_tuple (Operator)
Name
receive_tupleT_receive_tupleReceiveTupleReceiveTuplereceive_tuple — Receive a tuple over a socket connection.
Signature
Herror T_receive_tuple(const Htuple Socket, Htuple* Tuple)
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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
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