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.
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