tuple_removetuple_removeTupleRemoveTupleRemovetuple_remove (Operator)
Name
tuple_removetuple_removeTupleRemoveTupleRemovetuple_remove — Remove elements from a tuple.
Signature
def tuple_remove(tuple: MaybeSequence[Union[float, int, str]], index: MaybeSequence[int]) -> Sequence[Union[float, int, str]]
def tuple_remove_s(tuple: MaybeSequence[Union[float, int, str]], index: MaybeSequence[int]) -> Union[float, int, str]
Description
tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemovetuple_remove removes one or more elements from the tuple
TupleTupleTupleTupletupletuple and returns the rest in the tuple ReducedReducedReducedReducedreducedreduced.
IndexIndexIndexIndexindexindex determines the indices of the elements to remove. Thus,
IndexIndexIndexIndexindexindex may only contain integer values (any floating point
number within IndexIndexIndexIndexindexindex 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 TupleTupleTupleTupletupletuple is empty, the operator returns an empty tuple.
HDevelop In-line Operation
HDevelop provides an in-line operation for tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemovetuple_remove,
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
TupleTupleTupleTupletupletuple (input_control) tuple(-array) → HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Input tuple.
IndexIndexIndexIndexindexindex (input_control) integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Indices of the elements to remove.
ReducedReducedReducedReducedreducedreduced (output_control) tuple(-array) → HTupleSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Reduced tuple.
Alternatives
tuple_first_ntuple_first_nTupleFirstNTupleFirstNTupleFirstNtuple_first_n,
tuple_last_ntuple_last_nTupleLastNTupleLastNTupleLastNtuple_last_n,
tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelectTupleStrBitSelecttuple_str_bit_select,
tuple_concattuple_concatTupleConcatTupleConcatTupleConcattuple_concat,
tuple_inserttuple_insertTupleInsertTupleInsertTupleInserttuple_insert,
tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplacetuple_replace
See also
tuple_selecttuple_selectTupleSelectTupleSelectTupleSelecttuple_select,
tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMasktuple_select_mask
Module
Foundation