send_tupleT_send_tupleSendTupleSendTuplesend_tuple (Operator)
send_tupleT_send_tupleSendTupleSendTuplesend_tuple
— Send a tuple over a socket connection.
Signature
Herror T_send_tuple(const Htuple Socket, const Htuple Tuple)
def send_tuple(socket: HHandle, tuple: Union[float, int, str]) -> None
Description
send_tuplesend_tupleSendTupleSendTuplesend_tuple
sends a tuple TupleTupleTupletupletuple
over the socket connection
determined by SocketSocketSocketsocketsocket
.
The receiving HALCON process must call receive_tuplereceive_tupleReceiveTupleReceiveTuplereceive_tuple
to read the
tuple from the socket.
For a detailed example, see open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptopen_socket_accept
.
Attention
send_tuplesend_tupleSendTupleSendTuplesend_tuple
does not allow sending 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
SocketSocketSocketsocketsocket
(input_control) socket →
HSocket, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Socket number.
TupleTupleTupletupletuple
(input_control) string →
HTupleUnion[float, int, str]HTupleHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong)
Tuple to be sent.
Possible Predecessors
open_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnectopen_socket_connect
,
socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect
See also
receive_tuplereceive_tupleReceiveTupleReceiveTuplereceive_tuple
,
send_imagesend_imageSendImageSendImagesend_image
,
receive_imagereceive_imageReceiveImageReceiveImagereceive_image
,
send_regionsend_regionSendRegionSendRegionsend_region
,
receive_regionreceive_regionReceiveRegionReceiveRegionreceive_region
,
get_next_socket_data_typeget_next_socket_data_typeGetNextSocketDataTypeGetNextSocketDataTypeget_next_socket_data_type
Module
Foundation