KlassenKlassenKlassenKlassen | | | | Operatoren

get_sub_matrixget_sub_matrixGetSubMatrixget_sub_matrixGetSubMatrixGetSubMatrix (Operator)

Name

get_sub_matrixget_sub_matrixGetSubMatrixget_sub_matrixGetSubMatrixGetSubMatrix — Gibt einen Teil einer Matrix zurück.

Signatur

get_sub_matrix( : : MatrixID, Row, Column, RowsSub, ColumnsSub : MatrixSubID)

Herror get_sub_matrix(const Hlong MatrixID, const Hlong Row, const Hlong Column, const Hlong RowsSub, const Hlong ColumnsSub, Hlong* MatrixSubID)

Herror T_get_sub_matrix(const Htuple MatrixID, const Htuple Row, const Htuple Column, const Htuple RowsSub, const Htuple ColumnsSub, Htuple* MatrixSubID)

Herror get_sub_matrix(const HTuple& MatrixID, const HTuple& Row, const HTuple& Column, const HTuple& RowsSub, const HTuple& ColumnsSub, Hlong* MatrixSubID)

HMatrix HMatrix::GetSubMatrix(const HTuple& Row, const HTuple& Column, const HTuple& RowsSub, const HTuple& ColumnsSub) const

void GetSubMatrix(const HTuple& MatrixID, const HTuple& Row, const HTuple& Column, const HTuple& RowsSub, const HTuple& ColumnsSub, HTuple* MatrixSubID)

HMatrix HMatrix::GetSubMatrix(Hlong Row, Hlong Column, Hlong RowsSub, Hlong ColumnsSub) const

void HOperatorSetX.GetSubMatrix(
[in] VARIANT MatrixID, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT RowsSub, [in] VARIANT ColumnsSub, [out] VARIANT* MatrixSubID)

IHMatrixX* HMatrixX.GetSubMatrix(
[in] Hlong Row, [in] Hlong Column, [in] Hlong RowsSub, [in] Hlong ColumnsSub)

static void HOperatorSet.GetSubMatrix(HTuple matrixID, HTuple row, HTuple column, HTuple rowsSub, HTuple columnsSub, out HTuple matrixSubID)

HMatrix HMatrix.GetSubMatrix(int row, int column, int rowsSub, int columnsSub)

Beschreibung

Der Operator get_sub_matrixget_sub_matrixGetSubMatrixget_sub_matrixGetSubMatrixGetSubMatrix generiert eine neue Matrix MatrixSubMatrixSubMatrixSubMatrixSubMatrixSubmatrixSub und kopiert in diese einen Teil der Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix, die durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID gegeben ist. Der Teil der Matrix MatrixMatrixMatrixMatrixMatrixmatrix wird durch die obere linke Ecke (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn) und die Dimension der Teilmatrix (RowsSubRowsSubRowsSubRowsSubRowsSubrowsSub,ColumnsSubColumnsSubColumnsSubColumnsSubColumnsSubcolumnsSub) festgelegt. Der Operator gibt das Matrix Handle MatrixSubIDMatrixSubIDMatrixSubIDMatrixSubIDMatrixSubIDmatrixSubID der Matrix MatrixSubMatrixSubMatrixSubMatrixSubMatrixSubmatrixSub zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix möglich.

Achtung

Es müssen die Bedingungen 0 <= RowRowRowRowRowrow < Größe der Matrix MatrixMatrixMatrixMatrixMatrixmatrix in Zeilenrichtung, RowRowRowRowRowrow + RowsSubRowsSubRowsSubRowsSubRowsSubrowsSub <= Größe der Matrix MatrixMatrixMatrixMatrixMatrixmatrix in Zeilenrichtung, 0 <= ColumnColumnColumnColumnColumncolumn < Größe der Matrix MatrixMatrixMatrixMatrixMatrixmatrix in Spaltenrichtung und ColumnColumnColumnColumnColumncolumn + ColumnsSubColumnsSubColumnsSubColumnsSubColumnsSubcolumnsSub <= Größe der Matrix MatrixMatrixMatrixMatrixMatrixmatrix in Spaltenrichtung erfüllt sein.

Parallelisierung

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control)  matrix HMatrix, HTupleHTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Matrix Handle der Eingabematrix.

RowRowRowRowRowrow (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Obere Zeilenposition der Teilmatrix in der Eingabematrix.

Defaultwert: 0

Wertevorschläge: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100

Restriktion: Row >= 0

ColumnColumnColumnColumnColumncolumn (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Linke Spaltenposition der Teilmatrix in der Eingabematrix.

Defaultwert: 0

Wertevorschläge: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100

Restriktion: Column >= 0

RowsSubRowsSubRowsSubRowsSubRowsSubrowsSub (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Anzahl der Zeilen der Teilmatrix.

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100

Restriktion: RowsSub >= 1

ColumnsSubColumnsSubColumnsSubColumnsSubColumnsSubcolumnsSub (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Anzahl der Spalten der Teilmatrix.

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100

Restriktion: ColumnsSub >= 1

MatrixSubIDMatrixSubIDMatrixSubIDMatrixSubIDMatrixSubIDmatrixSubID (output_control)  matrix HMatrix, HTupleHTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Matrix Handle der Teilmatrix.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert get_sub_matrixget_sub_matrixGetSubMatrixget_sub_matrixGetSubMatrixGetSubMatrix 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

Siehe auch

set_sub_matrixset_sub_matrixSetSubMatrixset_sub_matrixSetSubMatrixSetSubMatrix

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren