KlassenKlassenKlassenKlassen | | | | Operatoren

tuple_insertT_tuple_insertTupleInserttuple_insertTupleInsertTupleInsert (Operator)

Name

tuple_insertT_tuple_insertTupleInserttuple_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)

Herror 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

void HOperatorSetX.TupleInsert(
[in] VARIANT Tuple, [in] VARIANT Index, [in] VARIANT InsertTuple, [out] VARIANT* Extended)

VARIANT HTupleX.TupleInsert(
[in] VARIANT Tuple, [in] VARIANT Index, [in] VARIANT InsertTuple)

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

HTuple HTuple.TupleInsert(HTuple index, HTuple insertTuple)

Beschreibung

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

Sonderfall: Leere Eingabetupel

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

Parallelisierung

Parameter

TupleTupleTupleTupleTupletuple (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Eingabetupel.

IndexIndexIndexIndexIndexindex (input_control)  number HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Startindex.

InsertTupleInsertTupleInsertTupleInsertTupleInsertTupleinsertTuple (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Tupel mit den einzufügenden Elementen.

ExtendedExtendedExtendedExtendedExtendedextended (output_control)  number-array HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Tupel mit den eingefügten Elementen.

Alternativen

tuple_concattuple_concatTupleConcattuple_concatTupleConcatTupleConcat, tuple_replacetuple_replaceTupleReplacetuple_replaceTupleReplaceTupleReplace, tuple_gen_consttuple_gen_constTupleGenConsttuple_gen_constTupleGenConstTupleGenConst

Siehe auch

tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren