get_sub_matrix — Gibt einen Teil einer Matrix zurück.
get_sub_matrix( : : MatrixID, Row, Column, RowsSub, ColumnsSub : MatrixSubID)
Der Operator get_sub_matrix generiert eine neue Matrix
MatrixSub und kopiert in diese einen Teil der
Eingabematrix Matrix, die durch das Matrix Handle
MatrixID gegeben ist. Der Teil der Matrix Matrix
wird durch die obere linke Ecke (Row,Column) und
die Dimension der Teilmatrix (RowsSub,ColumnsSub)
festgelegt. Der Operator gibt das Matrix Handle
MatrixSubID der Matrix MatrixSub zurück.
Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator
get_full_matrix möglich.
Es müssen die Bedingungen 0 <= Row < Größe
der Matrix Matrix in Zeilenrichtung, Row +
RowsSub <= Größe der Matrix Matrix
in Zeilenrichtung, 0 <= Column < Größe der
Matrix Matrix in Spaltenrichtung und Column
+ ColumnsSub <= Größe der Matrix
Matrix in Spaltenrichtung erfüllt sein.
MatrixID (input_control) matrix → (handle)
Matrix Handle der Eingabematrix.
Row (input_control) integer → (integer)
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
Column (input_control) integer → (integer)
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
RowsSub (input_control) integer → (integer)
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
ColumnsSub (input_control) integer → (integer)
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
MatrixSubID (output_control) matrix → (handle)
Matrix Handle der Teilmatrix.
Sind die Parameterwerte korrekt, dann liefert get_sub_matrix
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
get_full_matrix,
get_value_matrix
Foundation