deserialize_matrixdeserialize_matrixDeserializeMatrixdeserialize_matrixDeserializeMatrixDeserializeMatrix (Operator)

Name

deserialize_matrixdeserialize_matrixDeserializeMatrixdeserialize_matrixDeserializeMatrixDeserializeMatrix — Deserialisieren einer serialisierten Matrix.

Signatur

deserialize_matrix( : : SerializedItemHandle : MatrixID)

Beschreibung

deserialize_matrixdeserialize_matrixDeserializeMatrixdeserialize_matrixDeserializeMatrixDeserializeMatrix deserialisiert eine Matrix, welche mit serialize_matrixserialize_matrixSerializeMatrixserialize_matrixSerializeMatrixSerializeMatrix serialisiert wurde (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem für eine Einführung in die Grundlagen der Serialisierung). Die serialisierte Matrix wird in dem Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle übergeben. Die deserialisierten Werte werden in einer dafür automatisch erzeugten Matrix mit dem Handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID gespeichert. Zugriff auf die Elemente einer Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix möglich.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control) serialized_item → (integer)

Handle des serialisierten Elements.

MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID (output_control) matrix → (integer)

Matrix handle.

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

Vorgänger

fread_serialized_itemfread_serialized_itemFreadSerializedItemfread_serialized_itemFreadSerializedItemFreadSerializedItem, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItem, serialize_matrixserialize_matrixSerializeMatrixserialize_matrixSerializeMatrixSerializeMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix

Modul

Foundation

Operatoren