tuple_removetuple_removeTupleRemoveTupleRemove (Operator)
Name
tuple_removetuple_removeTupleRemoveTupleRemove
— Remove elements from a tuple.
Signature
Description
tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemove
removes one or more elements from the tuple
TupleTupleTupleTupletuple
and returns the rest in the tuple ReducedReducedReducedReducedreduced
.
IndexIndexIndexIndexindex
determines the indices of the elements to remove. Thus,
IndexIndexIndexIndexindex
may only contain integer values (any floating point
number within IndexIndexIndexIndexindex
must represent an integer value without
fraction). Note that indices of tuple elements start at 0, i.e. the first
tuple element has got the index 0. Duplicates and indices out of
range are ignored.
Exception: Empty input tuple
If TupleTupleTupleTupletuple
is empty, the operator returns an empty tuple.
HDevelop In-line Operation
HDevelop provides an in-line operation for tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemove
,
which can be used in an expression in the following syntax:
Reduced := remove(Tuple, Index)
Execution Information
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
TupleTupleTupleTupletuple
(input_control) tuple(-array) →
HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Input tuple.
IndexIndexIndexIndexindex
(input_control) integer(-array) →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Indices of the elements to remove.
ReducedReducedReducedReducedreduced
(output_control) tuple(-array) →
HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Reduced tuple.
Alternatives
tuple_first_ntuple_first_nTupleFirstNTupleFirstNTupleFirstN
,
tuple_last_ntuple_last_nTupleLastNTupleLastNTupleLastN
,
tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelectTupleStrBitSelect
,
tuple_concattuple_concatTupleConcatTupleConcatTupleConcat
,
tuple_inserttuple_insertTupleInsertTupleInsertTupleInsert
,
tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplace
See also
tuple_selecttuple_selectTupleSelectTupleSelectTupleSelect
,
tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMask
Module
Foundation