tuple_insertT_tuple_insertTupleInsertTupleInsert (Operator)

Name

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

Signatur

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

Herror T_tuple_insert(const Htuple Tuple, const Htuple Index, const Htuple InsertTuple, Htuple* Extended)

void TupleInsert(const HTuple& Tuple, const HTuple& Index, const HTuple& InsertTuple, HTuple* Extended)

HTuple HTuple::TupleInsert(const HTuple& Index, const HTuple& InsertTuple) const

static void HOperatorSet.TupleInsert(HTuple tuple, HTuple index, HTuple insertTuple, out HTuple extended)

HTuple HTuple.TupleInsert(HTuple index, HTuple insertTuple)

Beschreibung

tuple_inserttuple_insertTupleInsertTupleInsertTupleInsert fügt einzelne Elemente aus dem Tupel InsertTupleInsertTupleInsertTupleInsertTupleinsertTuple 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 InsertTupleInsertTupleInsertTupleInsertTupleinsertTuple 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 InsertTupleInsertTupleInsertTupleInsertTupleinsertTuple 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 InsertTupleInsertTupleInsertTupleInsertTupleinsertTuple 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 InsertTupleInsertTupleInsertTupleInsertTupleinsertTuple dürfen gleichzeitig Strings und Zahlen enthalten.

Sonderfall: Leere Eingabetupel

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

Ausführungsinformationen

Parameter

TupleTupleTupleTupletuple (input_control)  tuple(-array) HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Eingabetupel.

IndexIndexIndexIndexindex (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Startindex.

InsertTupleInsertTupleInsertTupleInsertTupleinsertTuple (input_control)  tuple(-array) HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Tupel mit den einzufügenden Elementen.

ExtendedExtendedExtendedExtendedextended (output_control)  tuple-array HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Tupel mit den eingefügten Elementen.

Alternativen

tuple_concattuple_concatTupleConcatTupleConcatTupleConcat, tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplace, tuple_gen_consttuple_gen_constTupleGenConstTupleGenConstTupleGenConst

Siehe auch

tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemove

Modul

Foundation