deserialize_matrixT_deserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix (Operator)

Name

deserialize_matrixT_deserialize_matrixDeserializeMatrixDeserializeMatrixdeserialize_matrix — Deserialisieren einer serialisierten Matrix.

Signatur

deserialize_matrix( : : SerializedItemHandle : MatrixID)

Beschreibung

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

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)

Handle des serialisierten Elements.

MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (output_control) matrix → (handle)

Matrix handle.

Ergebnis

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

Vorgänger

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item, serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixserialize_matrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixget_full_matrix

Modul

Foundation

Operatoren