receive_serialized_item
— Empfangen eines serialisierten Elements über eine Socket-Verbindung.
receive_serialized_item( : : Socket : SerializedItemHandle)
receive_serialized_item
liest ein serialisiertes Element,
welches von einem anderen HALCON-Prozess über die Socket-Verbindung
Socket
mit dem Operator send_serialized_item
geschickt worden ist (siehe
fwrite_serialized_item
für eine Einführung in die Grundlagen
der Serialisierung). Wenn noch kein serialisiertes Element verschickt
worden ist, wird der Prozess, der receive_serialized_item
aufgerufen hat, blockiert, bis genug Daten eingetroffen sind. Um
die Daten zu speichern wird eine neues serialisiertes Element
erzeugt und die Daten in diesem gespeichert. Der Operator gibt das
Handle des serialisierten
Elementes in dem Parameter SerializedItemHandle
zurück.
Für ein ausführliches Beispiel über die Nutzung einer Socket-Verbindung
siehe open_socket_accept
.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Socket
(input_control) socket →
(handle)
Nummer des Sockets.
SerializedItemHandle
(output_control) serialized_item →
(handle)
Handle des serialisierten Elements.
Sind die Parameterwerte korrekt, dann liefert
receive_serialized_item
den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
get_serialized_item_ptr
,
deserialize_matrix
,
deserialize_metrology_model
Foundation