insertinsertInsertInsertinsert (Operator)

Name

insertinsertInsertInsertinsert — Zuweisung eines Wertes an ein Tupelelement.

Warnung

insertinsertInsertInsertInsertinsert ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt.. Die modifizierende Version des insertinsertInsertInsertInsertinsert Operators wurde durch den Operator assign_atassign_atAssignAtAssignAtAssignAtassign_at ersetzt. Dieser verwendet im Freitexteditor die gleiche Notation wie insertinsertInsertInsertInsertinsert, so dass im Freitexteditor automatisch der richtige Operator verwendet wird. Die nicht-modifizierende Variante des insertinsertInsertInsertInsertinsert Operators wurde durch den Operator tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplacetuple_replace ersetzt.

Signatur

insert( : : Input, Value, Index : Result)

Beschreibung

insertinsertInsertInsertInsertinsert 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 ValueValueValueValuevaluevalue dem zu berechnenden Ausdruck entspricht, der dem Element IndexIndexIndexIndexindexindex des Tupels InputInputInputInputinputinput zugewiesen wird. Der Parameter ResultResultResultResultresultresult enthält den Namen der Variablen, der das Ergebnis zugewiesen wird.

Nur für den Fall, dass das mit dem Parameter InputInputInputInputinputinput übergebene Eingabetupel mit dem als ResultResultResultResultresultresult übergebenen Ausgabetupel identisch ist, kann der Operator insertinsertInsertInsertInsertinsert 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 InputInputInputInputinputinput und ResultResultResultResultresultresult 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 insertinsertInsertInsertInsertinsert kein neues Tupelelement hinzufügt, wenn an der angegebenen Position schon ein Wert gespeichert ist. Vielmehr wird der Wert an der Position IndexIndexIndexIndexindexindex ersetzt. Daher muss für ValueValueValueValuevaluevalue genau ein Wert (oder ein Ausdruck, der genau einen Wert liefert) übergeben werden.

Wenn der durch IndexIndexIndexIndexindexindex ü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.

Parameter

InputInputInputInputinputinput (input_control) real(-array) → (real / integer / string)

Tupel, in das ein Wert eingefügt werden soll.

Defaultwert: []

ValueValueValueValuevaluevalue (input_control) real → (real / integer / string)

Wert, der eingefügt werden soll.

Defaultwert: 1

Typischer Wertebereich: 0 ≤ Value Value Value Value value value ≤ 1000000

IndexIndexIndexIndexindexindex (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

ResultResultResultResultresultresult (output_control) real(-array) → (real / integer / string)

Ergebnistupel mit eingefügtem Wert.

Ergebnis

Ist der Ausdruck korrekt, dann liefert insertinsertInsertInsertInsertinsert den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode zurückgeliefert.

Alternativen

assignassignAssignAssignAssignassign

Modul

Foundation