deserialize_matrixT_deserialize_matrixDeserializeMatrixDeserializeMatrix (Operator)

Name

deserialize_matrixT_deserialize_matrixDeserializeMatrixDeserializeMatrix — Deserialisieren einer serialisierten Matrix.

Signatur

deserialize_matrix( : : SerializedItemHandle : MatrixID)

Beschreibung

deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrix deserialisiert eine Matrix, welche mit serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrix serialisiert wurde (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem für eine Einführung in die Grundlagen der Serialisierung). Die serialisierte Matrix wird in dem Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle übergeben. Die deserialisierten Werte werden in einer dafür automatisch erzeugten Matrix mit dem Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID gespeichert. Zugriff auf die Elemente einer Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix 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

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control) serialized_item → (handle)

Handle des serialisierten Elements.

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (output_control) matrix → (handle)

Matrix handle.

Ergebnis

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

Vorgänger

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem, serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix

Modul

Foundation

Operatoren