| Operatoren |
insert — Zuweisung eines Wertes an ein Tupelelement.
Dieser Operator ist veraltet und sollte daher nicht mehr in neuen Programmen verwendet werden. 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.
Tupel, in das ein Wert eingefügt werden soll.
Defaultwert: []
Wert, der eingefügt werden soll.
Defaultwert: 1
Typischer Wertebereich: 0 ≤ Value ≤ 1000000
Position an der der Wert eingefügt werden soll.
Defaultwert: 0
Wertevorschläge: 0, 1, 2, 3, 4, 5, 6
Minimale Schrittweite: 1
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
| Operatoren |