HALCON Reference Manual 10.0.2
Table of Contents / System / Sockets ClassesClassesClasses | | | Operators

receive_datareceive_datareceive_dataReceiveDataReceiveData (Operator)

Name

receive_datareceive_datareceive_dataReceiveDataReceiveData — Receive arbitrary data from external devices or applications using a generic socket connection.

Signature

receive_data( : : Socket, Format : Data, From)

Herror receive_data(const Hlong Socket, const char* Format, char* Data, char* From)

Herror T_receive_data(const Htuple Socket, const Htuple Format, Htuple* Data, Htuple* From)

Herror receive_data(const HTuple& Socket, const HTuple& Format, char* Data, char* From)

HTuple HSocket::ReceiveData(const HTuple& Format, HTuple* From) const

void HOperatorSetX.ReceiveData(
[in] VARIANT Socket, [in] VARIANT Format, [out] VARIANT* Data, [out] VARIANT* From)

VARIANT HSocketX.ReceiveData(
[in] VARIANT Format, [out] VARIANT* From)

static void HOperatorSet.ReceiveData(HTuple socket, HTuple format, out HTuple data, out HTuple from)

HTuple HSocket.ReceiveData(HTuple format, out HTuple from)

HTuple HSocket.ReceiveData(string format, out string from)

Description

receive_datareceive_datareceive_dataReceiveDataReceiveData receives arbitrary data over a generic socket connection. The received data is converted from a binary network packet to a value (or a tuple of values) using the parameter FormatFormatFormatFormatformat as specification and is well-suited to communicate with external devices or applications. This operator does not support the standard 'HALCON'"HALCON""HALCON""HALCON""HALCON" protocol, but is intended for arbitrary data transfer.

The received data is converted to a value or tuple of values using the parameter FormatFormatFormatFormatformat. It is possible to specify multiple formats. In this case the FromFromFromFromfrom parameter will contain a 3rd value which tells you which format has been used to convert the data. To decide which format to use the size of the necessary data for each format is calculated initially. When data is received, the first format string with the matching size is used to convert the data to values.

The parameter FromFromFromFromfrom contains the IP address or hostname and port of the communication partner. For UDP connections it can be used in the send_datasend_datasend_dataSendDataSendData operator to send a response.

Please see send_datasend_datasend_dataSendDataSendData for a detailed description of the format.

Parallelization

Parameters

SocketSocketSocketSocketsocket (input_control)  socket_id HSocket, HTupleHSocket, HTupleHSocketX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Socket number.

FormatFormatFormatFormatformat (input_control)  string(-array) HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Specification how to convert the data to tuples.

Default value: 'z' "z" "z" "z" "z"

DataDataDataDatadata (output_control)  string HTupleHTupleVARIANTHtuple (string / real / integer) (string / double / int / long) (char* / double / Hlong) (BSTR / double / Hlong) (char* / double / Hlong)

Value (or tuple of values) holding the received and converted data.

FromFromFromFromfrom (output_control)  string HTupleHTupleVARIANTHtuple (string / integer) (string / int / long) (char* / Hlong) (BSTR / Hlong) (char* / Hlong)

IP address or hostname and network port of the communication partner.

Possible Predecessors

open_socket_connectopen_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnect, socket_accept_connectsocket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnect, get_socket_paramget_socket_paramget_socket_paramGetSocketParamGetSocketParam, set_socket_paramset_socket_paramset_socket_paramSetSocketParamSetSocketParam

Possible Successors

close_socketclose_socketclose_socketCloseSocketCloseSocket

See also

send_datasend_datasend_dataSendDataSendData

Module

Foundation


Table of Contents / System / Sockets ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH