ClassesClassesClassesClasses | | | | Operators

deserialize_matrixdeserialize_matrixDeserializeMatrixdeserialize_matrixDeserializeMatrixDeserializeMatrix (Operator)

Name

deserialize_matrixdeserialize_matrixDeserializeMatrixdeserialize_matrixDeserializeMatrixDeserializeMatrix — Deserialize a serialized matrix.

Signature

deserialize_matrix( : : SerializedItemHandle : MatrixID)

Herror deserialize_matrix(const Hlong SerializedItemHandle, Hlong* MatrixID)

Herror T_deserialize_matrix(const Htuple SerializedItemHandle, Htuple* MatrixID)

Herror deserialize_matrix(const HTuple& SerializedItemHandle, Hlong* MatrixID)

void HMatrix::DeserializeMatrix(const HSerializedItem& SerializedItemHandle)

void DeserializeMatrix(const HTuple& SerializedItemHandle, HTuple* MatrixID)

void HMatrix::DeserializeMatrix(const HSerializedItem& SerializedItemHandle)

void HOperatorSetX.DeserializeMatrix(
[in] VARIANT SerializedItemHandle, [out] VARIANT* MatrixID)

void HMatrixX.DeserializeMatrix([in] IHSerializedItemX* SerializedItemHandle)

static void HOperatorSet.DeserializeMatrix(HTuple serializedItemHandle, out HTuple matrixID)

void HMatrix.DeserializeMatrix(HSerializedItem serializedItemHandle)

Description

deserialize_matrixdeserialize_matrixDeserializeMatrixdeserialize_matrixDeserializeMatrixDeserializeMatrix deserializes a matrix, that was serialized by serialize_matrixserialize_matrixSerializeMatrixserialize_matrixSerializeMatrixSerializeMatrix (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized matrix is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. The deserialized values are stored in an automatically created matrix with the handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID. Access to the elements of the matrix is possible e.g. with the operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix.

Parallelization

Parameters

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control)  serialized_item HSerializedItem, HTupleHTupleHSerializedItem, HTupleHSerializedItemX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the serialized item.

MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID (output_control)  matrix HMatrix, HTupleHTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Matrix handle.

Result

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

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItem, serialize_matrixserialize_matrixSerializeMatrixserialize_matrixSerializeMatrixSerializeMatrix

Possible Successors

get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix

Module

Foundation


ClassesClassesClassesClasses | | | | Operators