socket_accept_connectT_socket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect (Operator)

Name

socket_accept_connectT_socket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect — Accept a connection request on a listening socket of the protocol type 'HALCON'"HALCON""HALCON""HALCON""HALCON" or 'TCP'"TCP""TCP""TCP""TCP"/'TCP4'"TCP4""TCP4""TCP4""TCP4"/'TCP6'"TCP6""TCP6""TCP6""TCP6".

Signature

socket_accept_connect( : : AcceptingSocket, Wait : Socket)

Description

socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect accepts an incoming connection request, generated by open_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnectopen_socket_connect in another HALCON process or from an external application, on the listening socket AcceptingSocketAcceptingSocketAcceptingSocketacceptingSocketaccepting_socket. The listening socket must have been created earlier with open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptopen_socket_accept. Its timeout determines the timeout of the socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect call. If WaitWaitWaitwaitwait='true'"true""true""true""true", socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect waits until a connection request from another HALCON process arrives. If WaitWaitWaitwaitwait='false'"false""false""false""false", socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect returns with the error 5 ( H_MSG_FAIL) , if currently there are no connection requests from other HALCON processes. The value 'auto'"auto""auto""auto""auto" for WaitWaitWaitwaitwait automatically waits if the timeout of the accepting socket is not equal 0. The result of socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect is another socket SocketSocketSocketsocketsocket, which is used for a two-way communication with another process. After this connection has been established, data can be exchanged between the two processes by calling the appropriate send or receive operators. For a detailed example, see open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptopen_socket_accept.

For the data transfer with generic sockets only the operators send_datasend_dataSendDataSendDatasend_data and receive_datareceive_dataReceiveDataReceiveDatareceive_data are available.

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

AcceptingSocketAcceptingSocketAcceptingSocketacceptingSocketaccepting_socket (input_control) socket → (handle)

Socket number of the accepting socket.

WaitWaitWaitwaitwait (input_control) string → (string)

Should the operator wait until a connection request arrives?

Default: 'auto' "auto" "auto" "auto" "auto"

List of values: 'auto'"auto""auto""auto""auto", 'false'"false""false""false""false", 'true'"true""true""true""true"

SocketSocketSocketsocketsocket (output_control) socket → (handle)

Socket number.

Possible Predecessors

open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptopen_socket_accept

Possible Successors

send_imagesend_imageSendImageSendImagesend_image, receive_imagereceive_imageReceiveImageReceiveImagereceive_image, send_regionsend_regionSendRegionSendRegionsend_region, receive_regionreceive_regionReceiveRegionReceiveRegionreceive_region, send_tuplesend_tupleSendTupleSendTuplesend_tuple, receive_tuplereceive_tupleReceiveTupleReceiveTuplereceive_tuple, send_datasend_dataSendDataSendDatasend_data, receive_datareceive_dataReceiveDataReceiveDatareceive_data

Module

Foundation

Operators