receive_serialized_itemT_receive_serialized_itemReceiveSerializedItemReceiveSerializedItem (Operator)

Name

receive_serialized_itemT_receive_serialized_itemReceiveSerializedItemReceiveSerializedItem — Empfangen eines serialisierten Elements über eine Socket-Verbindung.

Signatur

receive_serialized_item( : : Socket : SerializedItemHandle)

Beschreibung

receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem liest ein serialisiertes Element, welches von einem anderen HALCON-Prozess über die Socket-Verbindung SocketSocketSocketSocketsocket mit dem Operator send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem geschickt worden ist (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem für eine Einführung in die Grundlagen der Serialisierung). Wenn noch kein serialisiertes Element verschickt worden ist, wird der Prozess, der receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem 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 SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle zurück. Für ein ausführliches Beispiel über die Nutzung einer Socket-Verbindung siehe open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAccept.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

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.

Parameter

SocketSocketSocketSocketsocket (input_control) socket → (handle)

Nummer des Sockets.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (output_control) serialized_item → (handle)

Handle des serialisierten Elements.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem

Nachfolger

get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtr, deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrix, deserialize_metrology_modeldeserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModelDeserializeMetrologyModel

Modul

Foundation

Operatoren