set_full_matrix
— Setzt alle Werte einer Matrix.
Der Operator set_full_matrix
setzt alle
Werte der Eingangsmatrix Matrix
, die durch das Matrix
Handle MatrixID
gegeben ist. Der Parameter Values
ist hierbei ein Tupel von Gleitpunkt- bzw. ganzen Zahlen, welches
die Werte enthält, die den Elementen der Matrix Matrix
zugewiesen werden. Ganzen Zahlen werden automatisch in
Gleitpunktzahlen konvertiert. In dem Parameter Values
müssen alle Werte zeilenweise vorliegen, d.h. Zeile für Zeile
gespeichert sein. Außerdem muss die Anzahl der in Values
übergebenen Werte 1 oder mit der Anzahl aller Elemente der Matrix
identisch sein.
Bemerkung: Mit dem Operator create_matrix
kann das gleiche
Ergebnis erzielt werden. Der Vorteil bei der Nutzung des Operators
set_full_matrix
liegt darin, dass eine nicht länger
benötigte Matrix wiederverwendet werden kann. Dadurch verkürzt sich
die Laufzeit der Operation.
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.
Values
(input_control) number(-array) →
(real / integer)
Zu setzende Werte der Matrixelemente.
Sind die Parameterwerte korrekt, dann liefert
set_full_matrix
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Foundation