copy_matrixT_copy_matrixCopyMatrixCopyMatrixcopy_matrix (Operator)

Name

copy_matrixT_copy_matrixCopyMatrixCopyMatrixcopy_matrix — Kopiert eine Matrix.

Signatur

copy_matrix( : : MatrixID : MatrixCopyID)

Beschreibung

Der Operator copy_matrixcopy_matrixCopyMatrixCopyMatrixCopyMatrixcopy_matrix erstellt die neue Matrix MatrixCopy und kopiert alle Elemente der Eingabematrix Matrix in die neue Matrix. Die Eingabematrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id definiert. Der Operator gibt das Matrix Handle MatrixCopyIDMatrixCopyIDMatrixCopyIDMatrixCopyIDmatrixCopyIDmatrix_copy_id der Matrix MatrixCopy zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix möglich. Mit diesem Operator kann eine Matrix gesichert werden, bevor die Matrix von den Operatoren set_value_matrixset_value_matrixSetValueMatrixSetValueMatrixSetValueMatrixset_value_matrix, set_full_matrixset_full_matrixSetFullMatrixSetFullMatrixSetFullMatrixset_full_matrix, set_sub_matrixset_sub_matrixSetSubMatrixSetSubMatrixSetSubMatrixset_sub_matrix oder set_diagonal_matrixset_diagonal_matrixSetDiagonalMatrixSetDiagonalMatrixSetDiagonalMatrixset_diagonal_matrix verändert wird.

Beispiel:

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

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control) matrix → (handle)

Matrix Handle der Eingabematrix.

MatrixCopyIDMatrixCopyIDMatrixCopyIDMatrixCopyIDmatrixCopyIDmatrix_copy_id (output_control) matrix → (handle)

Matrix Handle der kopierten Matrix.

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrixcreate_matrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrixget_value_matrix

Alternativen

repeat_matrixrepeat_matrixRepeatMatrixRepeatMatrixRepeatMatrixrepeat_matrix

Modul

Foundation

Operatoren