set_value_matrix — Setzt eines oder mehrere Elemente einer Matrix.
Der Operator set_value_matrix setzt die
Werte der Elemente der Eingangsmatrix Matrix an den
Positionen (Row,Column). Die Werte sind in dem Tupel
Value gegeben und können Gleitpunkt- bzw. ganze Zahlen
sein. Ganze Zahlen werden automatisch in Gleitpunktzahlen
konvertiert. Die Anzahl der Werte in Value muss mit der
Anzahl der Elemente von Row und Column
übereinstimmen. Außerdem muss die Bedingung 0
Row < Größe der Matrix in Zeilenrichtung und 0
Column < Größe der Matrix in
Spaltenrichtung erfüllt sein. Die Matrix Matrix ist durch
das Matrix Handle MatrixID definiert.
Beispiel:
Row = [0,2,1],
Column = [1,0,3],
Value = [1,-9,6]
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
MatrixID (input_control, Zustand wird modifiziert) matrix → (handle)
Matrix Handle der Eingabematrix.
Row (input_control) integer(-array) → (integer)
Zeilennummern der zu modifizierenden Elemente der Matrix.
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(-array) → (integer)
Spaltennummern der zu modifizierenden Elemente der Matrix.
Defaultwert: 0
Wertevorschläge: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriktion: Column >= 0
Value (input_control) number(-array) → (real / integer)
Zu setzende Werte an den angegebenen Matrix Elementen.
Defaultwert: 0
Wertevorschläge: 0, 1, -1
Sind die Parameterwerte korrekt, dann liefert
set_value_matrix den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Foundation