tuple_insertT_tuple_insertTupleInsertTupleInserttuple_insert (Operator)

Name

tuple_insertT_tuple_insertTupleInsertTupleInserttuple_insert — Einfügen von Elementen in ein Tupel ab Index.

Signatur

tuple_insert( : : Tuple, Index, InsertTuple : Extended)

Beschreibung

tuple_inserttuple_insertTupleInsertTupleInserttuple_insert fügt einzelne Elemente aus dem Tupel InsertTupleInsertTupleInsertTupleinsertTupleinsert_tuple ab Index in das Tupel TupleTupleTupletupletuple ein und gibt das veränderte Tupel mit dem Parameter ExtendedExtendedExtendedextendedextended zurück. Der Parameter IndexIndexIndexindexindex enthält hierbei den Startindex der einzufügenden Elemente und InsertTupleInsertTupleInsertTupleinsertTupleinsert_tuple die Elementwerte, die eingefügt werden. Alle nachfolgenden Tupelelemente verschieben sich nach hinten. Folgerichtig darf IndexIndexIndexindexindex ausschließlich eine ganze Zahl 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 der Indexwert der Tupellänge von TupleTupleTupletupletuple entspricht, so wird InsertTupleInsertTupleInsertTupleinsertTupleinsert_tuple hinten angefügt. Die Länge des Ausgabetupels ExtendedExtendedExtendedextendedextended entspricht somit immer der Summe der Länge der beiden Eingabetupel. Besteht TupleTupleTupletupletuple zum Beispiel aus den Werten [0,0,0,1,1,1] und enthalten IndexIndexIndexindexindex und InsertTupleInsertTupleInsertTupleinsertTupleinsert_tuple die Werte [3] und [2,2,2], so beinhaltet das Ausgabetupel ExtendedExtendedExtendedextendedextended die Ergebniswerte [0,0,0,2,2,2,1,1,1]. Die Eingabetupel TupleTupleTupletupletuple und InsertTupleInsertTupleInsertTupleinsertTupleinsert_tuple dürfen gleichzeitig Strings und Zahlen enthalten.

Sonderfall: Leere Eingabetupel

Falls eines oder mehrere Eingabetupel leer sind, wird eine Fehlermeldung angezeigt.

HDevelop Inline-Operation

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

Extended := insert(Tuple, Index, InsertTuple)