serialize_matrixT_serialize_matrixSerializeMatrixSerializeMatrix (Operator)

Name

serialize_matrixT_serialize_matrixSerializeMatrixSerializeMatrix — Serialisieren einer Matrix.

Signatur

serialize_matrix( : : MatrixID : SerializedItemHandle)

Beschreibung

serialize_matrixserialize_matrixSerializeMatrixSerializeMatrixSerializeMatrix serialisiert die Daten einer Matrix (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem für eine Einführung in die Grundlagen der Serialisierung). Dabei werden dieselben Daten in ein serialisiertes Element überführt, die von write_matrixwrite_matrixWriteMatrixWriteMatrixWriteMatrix in eine Datei geschrieben werden. Die Matrix wird in dem Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID übergeben. Die serialisierte Matrix wird in dem Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle zurückgegeben und kann mit deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrix wieder deserialisiert werden.

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

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control) matrix → (handle)

Matrix Handle.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (output_control) serialized_item → (handle)

Handle des serialisierten Elements.

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrix

Nachfolger

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem, send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem, deserialize_matrixdeserialize_matrixDeserializeMatrixDeserializeMatrixDeserializeMatrix

Modul

Foundation

Operatoren