tuple_replaceT_tuple_replaceTupleReplaceTupleReplace (Operator)

Name

tuple_replaceT_tuple_replaceTupleReplaceTupleReplace — Ersetzen einzelner Elemente aus einem Tupel.

Signatur

tuple_replace( : : Tuple, Index, ReplaceTuple : Replaced)

Beschreibung

tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplace ersetzt einzelne Elemente aus einem Tupel TupleTupleTupleTupletuple und gibt das veränderte Tupel mit dem Parameter ReplacedReplacedReplacedReplacedreplaced zurück. Der Parameter IndexIndexIndexIndexindex enthält hierbei die Indizes der Elemente und ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple die entsprechenden Elementwerte, die ersetzt werden. Folglich darf IndexIndexIndexIndexindex ausschließlich ganze Zahlen beinhalten (falls IndexIndexIndexIndexindex eine Gleitkommazahl enthält, so muss diese eine ganze Zahl repräsentieren; alle Nachkommastellen der Zahl müssen also 0 sein). Tupelindizes werden beginnend mit 0 gezählt, das heißt das erste Tupelelement wird über den Index 0 ausgewählt. Falls ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple nur einen Wert enthält, dann wird dieser an allen in IndexIndexIndexIndexindex angegebenen Indizes eingesetzt. Falls ein Indexwert größer als die bisherige Tupellänge ist, so wird das Ergebnistupel ReplacedReplacedReplacedReplacedreplaced entsprechend verlängert und mit Nullen aufgefüllt. Falls zum Beispiel TupleTupleTupleTupletuple [1] enthält, IndexIndexIndexIndexindex die Werte [2,4] enthält und ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple die Werte [3,5] enthält, so ergibt sich ReplacedReplacedReplacedReplacedreplaced gleich [1,0,3,0,5].

Die Eingabetupel TupleTupleTupleTupletuple und ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple dürfen gleichzeitig Strings und Zahlen enthalten.

Sonderfall: Leere Eingabetupel

Ist eines der beiden Tupel IndexIndexIndexIndexindex und ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple leer und das andere nicht, wird eine Fehlermeldung angezeigt. Sind beide leer, entspricht das Ausgabetupel ReplacedReplacedReplacedReplacedreplaced dem Eingabetupel TupleTupleTupleTupletuple. Sind beide nicht leer, aber das Eingabetuple TupleTupleTupleTupletuple ist leer, wird das leere Tupel entsprechend der oben beschriebenen Vorgehensweise erweitert.

HDevelop Inline-Operation

HDevelop unterstützt eine Inline-Operation für tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplace, die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden kann:

Replaced := replace(Tuple, Index, ReplaceTuple)