receive_serialized_itemT_receive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item (算子)
名称
receive_serialized_itemT_receive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item — 通过套接字连接接收序列化项。
签名
def receive_serialized_item(socket: HHandle) -> HHandle
描述
receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item receives a serialized item that was
sent over the socket connection determined by SocketSocketSocketSocketsocketsocket of
another HALCON process using the operator send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item
(see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the
basics of serialization). If no serialized item has been sent,
the HALCON process calling receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item blocks
until enough data arrives. The data is stored in a new created
serialized item. The operator returns the handle of the serialized
item in parameter SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. For a detailed
example showing the use of a socket connection, see
open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAcceptopen_socket_accept。
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
此算子返回一个句柄。请注意,即使该句柄被用作特定算子的输入参数,这些算子仍可能改变此句柄类型的实例状态。
参数
SocketSocketSocketSocketsocketsocket (输入控制) socket → HSocket, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Socket number.
SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (输出控制) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the serialized item.
结果
如果参数有效,算子
receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item 返回值 2 ( H_MSG_TRUE )。如有必要,则抛出异常。
可能的前趋
send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item
可能的后继
get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr,
deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrixdeserialize_matrix,
deserialize_metrology_modeldeserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModelDeserializeMetrologyModeldeserialize_metrology_model
模块
基础