ClassesClassesClassesClasses | | | | Operators

tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove (Operator)

Name

tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove — Remove elements from a tuple.

Signature

tuple_remove( : : Tuple, Index : Reduced)

Herror tuple_remove(const Hlong Tuple, const Hlong Index, Hlong* Reduced)

Herror T_tuple_remove(const Htuple Tuple, const Htuple Index, Htuple* Reduced)

Herror tuple_remove(const HTuple& Tuple, const HTuple& Index, Hlong* Reduced)

Herror tuple_remove(const HTuple& Tuple, const HTuple& Index, HTuple* Reduced)

void TupleRemove(const HTuple& Tuple, const HTuple& Index, HTuple* Reduced)

HTuple HTuple::TupleRemove(const HTuple& Index) const

void HOperatorSetX.TupleRemove(
[in] VARIANT Tuple, [in] VARIANT Index, [out] VARIANT* Reduced)

VARIANT HTupleX.TupleRemove(
[in] VARIANT Tuple, [in] VARIANT Index)

static void HOperatorSet.TupleRemove(HTuple tuple, HTuple index, out HTuple reduced)

HTuple HTuple.TupleRemove(HTuple index)

Description

tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove 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_removeTupleRemovetuple_removeTupleRemoveTupleRemove, which can be used in an expression in the following syntax:

Reduced := remove(Tuple, Index)

Parallelization

Parameters

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.

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

Indices of the elements to remove.

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

Reduced tuple.

Alternatives

tuple_first_ntuple_first_nTupleFirstNtuple_first_nTupleFirstNTupleFirstN, tuple_last_ntuple_last_nTupleLastNtuple_last_nTupleLastNTupleLastN, tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelect, tuple_concattuple_concatTupleConcattuple_concatTupleConcatTupleConcat, tuple_inserttuple_insertTupleInserttuple_insertTupleInsertTupleInsert, tuple_replacetuple_replaceTupleReplacetuple_replaceTupleReplaceTupleReplace

See also

tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect, tuple_select_masktuple_select_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask

Module

Foundation


ClassesClassesClassesClasses | | | | Operators