HALCON Website / HALCON Operator-Referenz / System / Sockets
KlassenKlassenKlassenKlassen | | | | Operatoren

receive_datareceive_dataReceiveDatareceive_dataReceiveDataReceiveData (Operator)

Name

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

Signatur

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 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

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)

Beschreibung

receive_datareceive_dataReceiveDatareceive_dataReceiveDataReceiveData liest Daten über die durch SocketSocketSocketSocketSocketsocket bestimmte generische Socket-Verbindung. Die Daten werden anhand des Parameters FormatFormatFormatFormatFormatformat 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""HALCON" Protokoll, sondern ist zum Empfang beliebiger Daten gedacht. Mit dem Operator send_datasend_dataSendDatasend_dataSendDataSendData können entsprechende Daten mit einem HALCON Prozess gesendet werden.

Die empfangenen Daten werden mittels des Parameters FormatFormatFormatFormatFormatformat in Werte oder Tupel von Werten konvertiert. Es können mehrere Formate angeben werden, in diesem Fall enthält der FromFromFromFromFromfrom 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 FromFromFromFromFromfrom 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_dataSendDatasend_dataSendDataSendData benutzt werden.

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

Parallelisierung

Parameter

SocketSocketSocketSocketSocketsocket (input_control)  socket_id → HSocket, HTupleHTupleHSocket, HTupleHSocketX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Nummer des Sockets.

FormatFormatFormatFormatFormatformat (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Vorschrift zur Konvertierung der Daten.

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

DataDataDataDataDatadata (output_control)  string → HTupleHTupleHTupleVARIANTHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong) (BSTR / double / Hlong) (char* / double / Hlong)

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

FromFromFromFromFromfrom (output_control)  string → HTupleHTupleHTupleVARIANTHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong) (BSTR / Hlong) (char* / Hlong)

IP-Adresse oder Netzwerkname und Netzwerkport der Gegenstelle.

Vorgänger

open_socket_connectopen_socket_connectOpenSocketConnectopen_socket_connectOpenSocketConnectOpenSocketConnect, socket_accept_connectsocket_accept_connectSocketAcceptConnectsocket_accept_connectSocketAcceptConnectSocketAcceptConnect, get_socket_paramget_socket_paramGetSocketParamget_socket_paramGetSocketParamGetSocketParam, set_socket_paramset_socket_paramSetSocketParamset_socket_paramSetSocketParamSetSocketParam

Nachfolger

close_socketclose_socketCloseSocketclose_socketCloseSocketCloseSocket

Siehe auch

send_datasend_dataSendDatasend_dataSendDataSendData

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH