ClassesClassesClassesClasses | | | | Operators

tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect (Operator)

Name

tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect — Select single elements of a tuple.

Signature

tuple_select( : : Tuple, Index : Selected)

Herror tuple_select(const Hlong Tuple, const Hlong Index, Hlong* Selected)

Herror T_tuple_select(const Htuple Tuple, const Htuple Index, Htuple* Selected)

Herror tuple_select(const HTuple& Tuple, const HTuple& Index, Hlong* Selected)

Herror tuple_select(const HTuple& Tuple, const HTuple& Index, HTuple* Selected)

void TupleSelect(const HTuple& Tuple, const HTuple& Index, HTuple* Selected)

HTuple HTuple::TupleSelect(const HTuple& Index) const

void HOperatorSetX.TupleSelect(
[in] VARIANT Tuple, [in] VARIANT Index, [out] VARIANT* Selected)

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

static void HOperatorSet.TupleSelect(HTuple tuple, HTuple index, out HTuple selected)

HTuple HTuple.TupleSelect(HTuple index)

Description

tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect selects one or more single elements of the tuple TupleTupleTupleTupleTupletuple and returns them with SelectedSelectedSelectedSelectedSelectedselected. At this, IndexIndexIndexIndexIndexindex determines the indices of the elements to select. Thus, IndexIndexIndexIndexIndexindex may only contain integer values (any floating point number within IndexIndexIndexIndexIndexindex must represent an integer value without fraction). Indices of tuple elements start at 0, that means, the first tuple element has got the index 0.

Exception: Empty input tuples

If TupleTupleTupleTupleTupletuple is empty, an exception is raised.

HDevelop In-line Operation

HDevelop provides an in-line operation for tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect, which can be used in an expression in the following syntax:

Selected := Tuple[Index]

Selected := subset(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 select.

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

Selected tuple element.

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_select_rangetuple_select_rangeTupleSelectRangetuple_select_rangeTupleSelectRangeTupleSelectRange, tuple_select_ranktuple_select_rankTupleSelectRanktuple_select_rankTupleSelectRankTupleSelectRank

See also

tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove

Module

Foundation


ClassesClassesClassesClasses | | | | Operators