receive_tupleT_receive_tupleReceiveTupleReceiveTuple (Operator)
Name
receive_tupleT_receive_tupleReceiveTupleReceiveTuple — Receive a tuple over a socket connection.
Signature
Herror T_receive_tuple(const Htuple Socket, Htuple* Tuple)
Description
receive_tuplereceive_tupleReceiveTupleReceiveTupleReceiveTuple reads a tuple that was sent over the socket
connection determined by SocketSocketSocketSocketsocket by another HALCON process
using the operator send_tuplesend_tupleSendTupleSendTupleSendTuple. If no tuple has been sent,
the HALCON process calling receive_tuplereceive_tupleReceiveTupleReceiveTupleReceiveTuple blocks until enough
data arrives. For a detailed example, see
open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAccept.
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
SocketSocketSocketSocketsocket (input_control) socket → HSocket, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Socket number.
TupleTupleTupleTupletuple (output_control) string → HTupleHTupleHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong)
Received tuple.
Possible Predecessors
open_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnectOpenSocketConnect,
socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectSocketAcceptConnect,
get_socket_paramget_socket_paramGetSocketParamGetSocketParamGetSocketParam,
set_socket_paramset_socket_paramSetSocketParamSetSocketParamSetSocketParam
See also
send_tuplesend_tupleSendTupleSendTupleSendTuple,
send_imagesend_imageSendImageSendImageSendImage,
receive_imagereceive_imageReceiveImageReceiveImageReceiveImage,
send_regionsend_regionSendRegionSendRegionSendRegion,
receive_regionreceive_regionReceiveRegionReceiveRegionReceiveRegion,
get_next_socket_data_typeget_next_socket_data_typeGetNextSocketDataTypeGetNextSocketDataTypeGetNextSocketDataType
Module
Foundation