serialize_handleT_serialize_handleSerializeHandleSerializeHandleserialize_handle (Operator)

Name

serialize_handleT_serialize_handleSerializeHandleSerializeHandleserialize_handle — Serialize the content of a handle.

Signature

serialize_handle( : : Handle : SerializedItem)

Description

serialize_handleserialize_handleSerializeHandleSerializeHandleserialize_handle serializes the content of HandleHandleHandlehandlehandle and returns the serialized item in SerializedItemSerializedItemSerializedItemserializedItemserialized_item (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized item can later be deserialized with deserialize_handledeserialize_handleDeserializeHandleDeserializeHandledeserialize_handle.

Note that not all handle types support serialization. To check if a handle can be serializes, use tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializabletuple_is_serializable or tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem. Handles that have already been cleared cannot be serialized.

Also note that the serialized item created by this operator is compatible with the type specific deserialization operators, such as deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix or deserialize_shape_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModeldeserialize_shape_model.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

HandleHandleHandlehandlehandle (input_control) handle → (handle)

Handle that should be serialized.

SerializedItemSerializedItemSerializedItemserializedItemserialized_item (output_control) serialized_item → (handle)

Handle containing the serialized item.

Example (HDevelop)

create_matrix (3, 3, 0, MatrixID)
serialize_handle (MatrixID, SerializedMatrix)
deserialize_handle (SerializedMatrix, MatrixID2)

Result

If the parameters are valid, the operator serialize_handleserialize_handleSerializeHandleSerializeHandleserialize_handle returns the value 2 ( H_MSG_TRUE) . Otherwise, an exception is raised.

Possible Predecessors

tuple_is_serializabletuple_is_serializableTupleIsSerializableTupleIsSerializabletuple_is_serializable, tuple_is_serializable_elemtuple_is_serializable_elemTupleIsSerializableElemTupleIsSerializableElemtuple_is_serializable_elem

Possible Successors

deserialize_handledeserialize_handleDeserializeHandleDeserializeHandledeserialize_handle, fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item

Module

Foundation

Operators