copy_matrixcopy_matrixCopyMatrixcopy_matrixCopyMatrixCopyMatrix (Operator)

Name

copy_matrixcopy_matrixCopyMatrixcopy_matrixCopyMatrixCopyMatrix — Kopiert eine Matrix.

Signatur

Beschreibung

Der Operator copy_matrixcopy_matrixCopyMatrixcopy_matrixCopyMatrixCopyMatrix erstellt die neue Matrix MatrixCopyMatrixCopyMatrixCopyMatrixCopyMatrixCopymatrixCopy und kopiert alle Elemente der Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix in die neue Matrix. Die Eingabematrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID definiert. Der Operator gibt das Matrix Handle MatrixCopyIDMatrixCopyIDMatrixCopyIDMatrixCopyIDMatrixCopyIDmatrixCopyID der Matrix MatrixCopyMatrixCopyMatrixCopyMatrixCopyMatrixCopymatrixCopy zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix möglich. Mit diesem Operator kann eine Matrix gesichert werden, bevor die Matrix von den Operatoren set_value_matrixset_value_matrixSetValueMatrixset_value_matrixSetValueMatrixSetValueMatrix, set_full_matrixset_full_matrixSetFullMatrixset_full_matrixSetFullMatrixSetFullMatrix, set_sub_matrixset_sub_matrixSetSubMatrixset_sub_matrixSetSubMatrixSetSubMatrix oder set_diagonal_matrixset_diagonal_matrixSetDiagonalMatrixset_diagonal_matrixSetDiagonalMatrixSetDiagonalMatrix verändert wird.

Beispiel:

           /   3.0   1.0  -2.0  \                   /   3.0   1.0  -2.0  \
  Matrix = |  -5.0   7.0   2.0  |  ->  MatrixCopy = |  -5.0   7.0   2.0  |
           \  -9.0  -4.0   1.0  /                   \  -9.0  -4.0   1.0  /

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

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixcreate_matrixCreateMatrixCreateMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixGetValueMatrixget_value_matrixGetValueMatrixGetValueMatrix

Alternativen

repeat_matrixrepeat_matrixRepeatMatrixrepeat_matrixRepeatMatrixRepeatMatrix

Modul

Foundation