serialize_tupleT_serialize_tupleSerializeTupleSerializeTupleserialize_tuple (算子)
名称
serialize_tupleT_serialize_tupleSerializeTupleSerializeTupleserialize_tuple — 序列化元组。
签名
def serialize_tuple(tuple: HTupleType) -> HHandle
描述
serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTupleserialize_tuple serializes the data of a tuple (see
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic
principle of serialization). The same data that is written in a
file by write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple is converted to a serialized item.
The tuple is defined by the handle TupleTupleTupleTupletupletuple. The
serialized data of a tuple is returned by the handle
SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle and can be deserialized by
deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTupledeserialize_tuple。
Note that not all handle types can be serialized.
If TupleTupleTupleTupletupletuple contains a handle that can not be serialized or that
has been freed already, an exception is raised.
The operators tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializableTupleIsSerializabletuple_is_serializable and
tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem can be used to find out if a tuple or
its elements can be serialized.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
TupleTupleTupleTupletupletuple (输入控制) tuple(-array) → HTupleHTupleTypeHTupleHtuple (real / integer / string / handle) (double / int / long / string / HHandle) (double / Hlong / HString / HHandle) (double / Hlong / char* / handle)
Tuple.
SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (输出控制) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the serialized item.
结果
如果参数有效，算子
serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTupleserialize_tuple 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。
可能的后继
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item,
send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item,
deserialize_tupledeserialize_tupleDeserializeTupleDeserializeTupleDeserializeTupledeserialize_tuple
模块
基础