copy_matrixcopy_matrixCopyMatrixCopyMatrix (Operator)

Name

copy_matrixcopy_matrixCopyMatrixCopyMatrix — Kopiert eine Matrix.

Signatur

Beschreibung

Der Operator copy_matrixcopy_matrixCopyMatrixCopyMatrixCopyMatrix erstellt die neue Matrix MatrixCopyMatrixCopyMatrixCopyMatrixCopymatrixCopy und kopiert alle Elemente der Eingabematrix MatrixMatrixMatrixMatrixmatrix in die neue Matrix. Die Eingabematrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID definiert. Der Operator gibt das Matrix Handle MatrixCopyIDMatrixCopyIDMatrixCopyIDMatrixCopyIDmatrixCopyID der Matrix MatrixCopyMatrixCopyMatrixCopyMatrixCopymatrixCopy zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix möglich. Mit diesem Operator kann eine Matrix gesichert werden, bevor die Matrix von den Operatoren set_value_matrixset_value_matrixSetValueMatrixSetValueMatrixSetValueMatrix, set_full_matrixset_full_matrixSetFullMatrixSetFullMatrixSetFullMatrix, set_sub_matrixset_sub_matrixSetSubMatrixSetSubMatrixSetSubMatrix oder set_diagonal_matrixset_diagonal_matrixSetDiagonalMatrixSetDiagonalMatrixSetDiagonalMatrix verändert wird.

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

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrix

Alternativen

repeat_matrixrepeat_matrixRepeatMatrixRepeatMatrixRepeatMatrix

Modul

Foundation