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