Name
tuple_insertT_tuple_insertTupleInserttuple_insertTupleInsertTupleInsert — Inserts one or more elements into a tuple at index.
tuple_inserttuple_insertTupleInserttuple_insertTupleInsertTupleInsert inserts the elements of the tuple InsertTupleInsertTupleInsertTupleInsertTupleInsertTupleinsertTuple
at index into the tuple TupleTupleTupleTupleTupletuple and returns them in the tuple
ExtendedExtendedExtendedExtendedExtendedextended.
In this context IndexIndexIndexIndexIndexindex determines the start index of the elements
and InsertTupleInsertTupleInsertTupleInsertTupleInsertTupleinsertTuple the values to insert. Successive values of
TupleTupleTupleTupleTupletuple will be positioned after the inserted values of
InsertTupleInsertTupleInsertTupleInsertTupleInsertTupleinsertTuple.
The parameter IndexIndexIndexIndexIndexindex must contain a single integer value
(any floating point number must represent an integer value without
fraction). Indices of tuple elements start at 0. Therefore, the first
tuple element has got the index 0. If IndexIndexIndexIndexIndexindex contains the
length of TupleTupleTupleTupleTupletuple as index, InsertTupleInsertTupleInsertTupleInsertTupleInsertTupleinsertTuple will be
appended.
The length of the result tuple ExtendedExtendedExtendedExtendedExtendedextended is always the sum of
the two input tuples TupleTupleTupleTupleTupletuple and InsertTupleInsertTupleInsertTupleInsertTupleInsertTupleinsertTuple.
For example, if TupleTupleTupleTupleTupletuple contains the values [0,1,0,1,0,1],
the IndexIndexIndexIndexIndexindex contains the value [3] and the
InsertTupleInsertTupleInsertTupleInsertTupleInsertTupleinsertTuple contains the values [2,2,2], then the output
tuple ExtendedExtendedExtendedExtendedExtendedextended will contain the values [0,1,0,2,2,2,1,0,1].
It is allowed to mix strings and numbers in the input tuples
TupleTupleTupleTupleTupletuple and InsertTupleInsertTupleInsertTupleInsertTupleInsertTupleinsertTuple.
Exception: Empty input tuples
If any of the input tuples is empty, an exception is raised.
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
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*)
Input tuple.
Start index of elements to be inserted.
Element(s) to insert at index.
Tuple with inserted elements.
tuple_concattuple_concatTupleConcattuple_concatTupleConcatTupleConcat,
tuple_replacetuple_replaceTupleReplacetuple_replaceTupleReplaceTupleReplace,
tuple_gen_consttuple_gen_constTupleGenConsttuple_gen_constTupleGenConstTupleGenConst
tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove
Foundation