Name
copy_matrixcopy_matrixCopyMatrixcopy_matrixCopyMatrixCopyMatrix — Copy a matrix.
The operator copy_matrixcopy_matrixCopyMatrixcopy_matrixCopyMatrixCopyMatrix creates the new matrix
MatrixCopyMatrixCopyMatrixCopyMatrixCopyMatrixCopymatrixCopy and copies all elements of the input
MatrixMatrixMatrixMatrixMatrixmatrix to this new matrix. The input MatrixMatrixMatrixMatrixMatrixmatrix is
defined by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID. The operator
returns the matrix handle MatrixCopyIDMatrixCopyIDMatrixCopyIDMatrixCopyIDMatrixCopyIDmatrixCopyID of the matrix
MatrixCopyMatrixCopyMatrixCopyMatrixCopyMatrixCopymatrixCopy. Access to the elements of the matrix is
possible e.g. with the operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix.
With this operator a matrix can be saved
before the matrix is modified by the operators
set_value_matrixset_value_matrixSetValueMatrixset_value_matrixSetValueMatrixSetValueMatrix, set_full_matrixset_full_matrixSetFullMatrixset_full_matrixSetFullMatrixSetFullMatrix,
set_sub_matrixset_sub_matrixSetSubMatrixset_sub_matrixSetSubMatrixSetSubMatrix, or set_diagonal_matrixset_diagonal_matrixSetDiagonalMatrixset_diagonal_matrixSetDiagonalMatrixSetDiagonalMatrix.
Example:
/ 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 /
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Matrix handle of the input matrix.
Matrix handle of the copied matrix.
If the parameters are valid, the operator copy_matrixcopy_matrixCopyMatrixcopy_matrixCopyMatrixCopyMatrix
returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.
create_matrixcreate_matrixCreateMatrixcreate_matrixCreateMatrixCreateMatrix
get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix,
get_value_matrixget_value_matrixGetValueMatrixget_value_matrixGetValueMatrixGetValueMatrix
repeat_matrixrepeat_matrixRepeatMatrixrepeat_matrixRepeatMatrixRepeatMatrix
Foundation