insert — Zuweisung eines Wertes an ein Tupelelement.
insert ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt..
Die modifiziernde Version des insert Operators wurde durch den
Operator assign_at ersetzt.
Dieser verwendet im Freitexteditor die gleiche Notation wie insert,
so dass im Freitexteditor automatisch der richtige Operator verwendet wird.
Die nicht-modifizierende Variante des insert Operators wurde durch
den Operator tuple_replace ersetzt.
insert weist einem spezifischen Tupelelement einen neuen Wert zu.
Im Freitexteditor wird eine solche Operation einfach mithilfe des Zuweisungsoperators := und des Indexoperators [ ] für die Ergebnisvariable eingetragen, zum Beispiel: Areas[Radius-1] := Area
Wird eine Einfügeoperation im Operatorfenster eingegeben, muss insert
in die Operatorauswahlbox eingetragen werden.
Daraufhin öffnet sich der Parameterbereich, in dem der Parameter
Value dem zu berechnenden Ausdruck entspricht, der dem Element
Index des Tupels Input zugewiesen wird.
Der Parameter Result enthält den Namen der Variablen, der das
Ergebnis zugewiesen wird.
Nur für den Fall, dass das mit dem Parameter Input übergebene
Eingabetupel mit dem als Result übergebenen Ausgabetupel identisch
ist, kann der Operator insert mit der oben dargestellten Schreibweise
im Freitexteditor eingegeben werden.
In diesem Fall wird das Eingabetupel modifiziert. Die korrekte
Operatorschreibweise sieht dann folgendermaßen aus:
insert (Areas, Area, Radius-1, Areas)
Wenn die Tupel Input und Result unterschiedlich sind, wird
das Eingabetupel nicht modifiziert.
In diesem Fall kann im Programmeditor nur die Operatorschreibweise verwendet
werden:
insert (Areas, Area, Radius-1, Result)
Dies entspricht der Schreibweise: Result := Areas Result[Radius-1] := Area
Es ist zu beachten, dass der Operator insert kein neues Tupelelement
hinzufügt, wenn an der angegebenen Position schon ein Wert gespeichert ist.
Vielmehr wird der Wert an der Position Index ersetzt.
Daher muss für Value genau ein Wert (oder ein Ausdruck, der genau
einen Wert liefert) übergeben werden.
Wenn der durch Index übergebene Wert größer ist als die aktuelle
Tupelgröße, wird das Tupel auf die erforderliche Größe gebracht. Die
Tupelelemente zwischen dem ursprünglich letzten und dem neuen Element sind
undefiniert.
Input (input_control) real(-array) → (real / integer / string)
Tupel, in das ein Wert eingefügt werden soll.
Defaultwert: []
Value (input_control) real → (real / integer / string)
Wert, der eingefügt werden soll.
Defaultwert: 1
Typischer Wertebereich: 0
≤
Value
≤
1000000
Index (input_control) integer → (integer)
Position an der der Wert eingefügt werden soll.
Defaultwert: 0
Wertevorschläge: 0, 1, 2, 3, 4, 5, 6
Minimale Schrittweite: 1
Result (output_control) real(-array) → (real / integer / string)
Ergebnistupel mit eingefügtem Wert.
Ist der Ausdruck korrekt, dann liefert
insert den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode
zurückgeliefert.
Foundation