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)

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)

def tuple_insert(tuple: MaybeSequence[Union[float, int, str]], index: int, insert_tuple: MaybeSequence[Union[float, int, str]]) -> Sequence[Union[float, int, str]]

Beschreibung

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

Sonderfall: Leere Eingabetupel

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

Ausführungsinformationen

Parameter

TupleTupleTupleTupletupletuple (input_control)  tuple(-array) HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Eingabetupel.

IndexIndexIndexIndexindexindex (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Startindex.

InsertTupleInsertTupleInsertTupleInsertTupleinsertTupleinsert_tuple (input_control)  tuple(-array) HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Tupel mit den einzufügenden Elementen.

ExtendedExtendedExtendedExtendedextendedextended (output_control)  tuple-array HTupleSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Tupel mit den eingefügten Elementen.

Alternativen

tuple_concattuple_concatTupleConcatTupleConcatTupleConcattuple_concat, tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplacetuple_replace, tuple_gen_consttuple_gen_constTupleGenConstTupleGenConstTupleGenConsttuple_gen_const

Siehe auch

tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemovetuple_remove

Modul

Foundation