Skip to content

receive_xldReceiveXldReceiveXldreceive_xldT_receive_xld🔗

Short description🔗

receive_xldReceiveXldReceiveXldreceive_xldT_receive_xld — Receive an XLD object over a socket connection.

Signature🔗

receive_xld( out xld XLD, socket Socket )void ReceiveXld( HObject* XLD, const HTuple& Socket )static void HOperatorSet.ReceiveXld( out HObject XLD, HTuple socket )def receive_xld( socket: HHandle ) -> HObject

Herror T_receive_xld( Hobject* XLD, const Htuple Socket )

HXLD HSocket::ReceiveXld( ) const

void HXLD::ReceiveXld( const HSocket& Socket )

HXLD HSocket.ReceiveXld( )

void HXLD.ReceiveXld( HSocket socket )

Description🔗

receive_xldReceiveXld reads an XLD object that was sent over the socket connection determined by Socketsocketsocket by another HALCON process using the operator send_xldSendXld. If no XLD object has been sent, the HALCON process calling receive_xldReceiveXld blocks until enough data arrives. For a detailed example, see send_xldSendXld.

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🔗

XLDXLDxld (output_object) xld(-array) → objectHObjectHXLDHObjectHobject *

Received XLD object.

Socketsocketsocket (input_control) socket → (handle)HTuple (HHandle)HSocket, HTuple (IntPtr)HHandleHtuple (handle)

Socket number.

Combinations with other operators🔗

Combinations

Possible predecessors

open_socket_connectOpenSocketConnect, socket_accept_connectSocketAcceptConnect, get_socket_paramGetSocketParam, set_socket_paramSetSocketParam

See also

send_xldSendXld, send_imageSendImage, receive_imageReceiveImage, send_regionSendRegion, receive_regionReceiveRegion, send_tupleSendTuple, receive_tupleReceiveTuple, get_next_socket_data_typeGetNextSocketDataType

Module🔗

Foundation