deserialize_matrixT_deserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix (Operator)

Name

deserialize_matrixT_deserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix — Deserialisieren einer serialisierten Matrix.

Signatur

deserialize_matrix( : : SerializedItemHandle : MatrixID)

Beschreibung

deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrixdeserialize_matrix deserialisiert eine Matrix, welche mit serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrixserialize_matrix serialisiert wurde (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item für eine Einführung in die Grundlagen der Serialisierung). Die serialisierte Matrix wird in dem Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle übergeben. Die deserialisierten Werte werden in einer dafür automatisch erzeugten Matrix mit dem Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id gespeichert. Zugriff auf die Elemente einer Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix möglich.

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.

Parameter

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)

Handle des serialisierten Elements.

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (output_control) matrix → (handle)

Matrix handle.

Ergebnis

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

Vorgänger

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item, serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrixserialize_matrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix

Modul

Foundation

Operatoren