receive_dataT_receive_dataReceiveDataReceiveData (Operator)

Name

receive_dataT_receive_dataReceiveDataReceiveData — Empfangen von Daten über eine generische Socket-Verbindung auch von externen Geräten oder Anwendungen.

Signatur

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

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

void ReceiveData(const HTuple& Socket, const HTuple& Format, HTuple* Data, HTuple* From)

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

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

HTuple HSocket::ReceiveData(const char* Format, HString* From) const

HTuple HSocket::ReceiveData(const wchar_t* Format, HString* From) const   (Nur Windows)

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)

Beschreibung

receive_datareceive_dataReceiveDataReceiveDataReceiveData liest Daten über die durch SocketSocketSocketSocketsocket bestimmte generische Socket-Verbindung. Die Daten werden anhand des Parameters FormatFormatFormatFormatformat aus einem binären Netzwerkpaket in einen Wert oder ein Tupel von Werten umgewandelt und sind gut zur Kommunikation mit externen Geräten oder Anwendungen geeignet. Dieser Operator unterstützt nicht das Standard 'HALCON'"HALCON""HALCON""HALCON""HALCON" Protokoll, sondern ist zum Empfang beliebiger Daten gedacht. Mit dem Operator send_datasend_dataSendDataSendDataSendData können entsprechende Daten mit einem HALCON Prozess gesendet werden.

Die empfangenen Daten werden mittels des Parameters FormatFormatFormatFormatformat in Werte oder Tupel von Werten konvertiert. Es können mehrere Formate angeben werden, in diesem Fall enthält der FromFromFromFromfrom Parameter einen dritten Wert, welcher den Index des verwendeten Formats angibt. Um ein passendes Format zu finden, wird die Größe des notwendigen Buffers initial berechnet. Beim Empfang von Daten wird das erste Format verwendet, welches eine passende Größe spezifiziert, um die binären Daten in Werte zu verwandeln.

Der Parameter FromFromFromFromfrom enthält die IP Adresse oder den Netzwerknamen und den Netzwerkport des Kommunikationspartners. Bei UDP Verbindungen können diese Werte für eine Antwort mittels send_datasend_dataSendDataSendDataSendData benutzt werden.

Eine detaillierte Beschreibung des Formats finden Sie in der Dokumentation des Operators send_datasend_dataSendDataSendDataSendData.

Ausführungsinformationen

Parameter

SocketSocketSocketSocketsocket (input_control)  socket HSocket, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Nummer des Sockets.

FormatFormatFormatFormatformat (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Vorschrift zur Konvertierung der Daten.

Defaultwert: 'z' "z" "z" "z" "z"

DataDataDataDatadata (output_control)  string HTupleHTupleHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong)

Wert (oder Tupel von Werten) mit den empfangenen und konvertierten Daten.

FromFromFromFromfrom (output_control)  string HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

IP-Adresse oder Netzwerkname und Netzwerkport der Gegenstelle.

Vorgänger

open_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnectOpenSocketConnect, socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectSocketAcceptConnect, get_socket_paramget_socket_paramGetSocketParamGetSocketParamGetSocketParam, set_socket_paramset_socket_paramSetSocketParamSetSocketParamSetSocketParam

Nachfolger

close_socketclose_socketCloseSocketCloseSocketCloseSocket

Siehe auch

send_datasend_dataSendDataSendDataSendData

Modul

Foundation