The operator get_diagonal_matrixget_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrixGetDiagonalMatrixget_diagonal_matrix generates a new matrix
VectorVectorVectorVectorvectorvector and copies the diagonal elements of the
MatrixMatrixMatrixMatrixmatrixmatrix to this new matrix. The MatrixMatrixMatrixMatrixmatrixmatrix is
defined by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id. The matrix
VectorVectorVectorVectorvectorvector has one column and n rows, where n = number of
diagonal elements. The operator returns the matrix handle
VectorIDVectorIDVectorIDVectorIDvectorIDvector_id of the matrix VectorVectorVectorVectorvectorvector. Access to the
elements of the matrix is possible e.g. with the operator
get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix.
If the parameters are valid, the operator
get_diagonal_matrixget_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrixGetDiagonalMatrixget_diagonal_matrix returns the value 2 (H_MSG_TRUE). If necessary,
an exception is raised.