ClassesClassesClassesClasses | | | | Operators

tuple_select_ranktuple_select_rankTupleSelectRanktuple_select_rankTupleSelectRankTupleSelectRank (Operator)

Name

tuple_select_ranktuple_select_rankTupleSelectRanktuple_select_rankTupleSelectRankTupleSelectRank — Select the element of rank n of a tuple.

Signature

tuple_select_rank( : : Tuple, RankIndex : Selected)

Herror tuple_select_rank(const Hlong Tuple, const Hlong RankIndex, Hlong* Selected)

Herror T_tuple_select_rank(const Htuple Tuple, const Htuple RankIndex, Htuple* Selected)

Herror tuple_select_rank(const HTuple& Tuple, const HTuple& RankIndex, Hlong* Selected)

void TupleSelectRank(const HTuple& Tuple, const HTuple& RankIndex, HTuple* Selected)

HTuple HTuple::TupleSelectRank(const HTuple& RankIndex) const

void HOperatorSetX.TupleSelectRank(
[in] VARIANT Tuple, [in] VARIANT RankIndex, [out] VARIANT* Selected)

VARIANT HTupleX.TupleSelectRank(
[in] VARIANT Tuple, [in] VARIANT RankIndex)

static void HOperatorSet.TupleSelectRank(HTuple tuple, HTuple rankIndex, out HTuple selected)

HTuple HTuple.TupleSelectRank(HTuple rankIndex)

Description

tuple_select_ranktuple_select_rankTupleSelectRanktuple_select_rankTupleSelectRankTupleSelectRank sorts the elements of the tuple TupleTupleTupleTupleTupletuple and returns the element of rank n in SelectedSelectedSelectedSelectedSelectedselected. RankIndexRankIndexRankIndexRankIndexRankIndexrankIndex determines the index of the element to select. Thus, RankIndexRankIndexRankIndexRankIndexRankIndexrankIndex may only contain integer values (any floating point number in RankIndexRankIndexRankIndexRankIndexRankIndexrankIndex must represent an integer value without fraction). Indices of tuple elements start at 0, i.e. the lowest tuple element has the index 0.

Exception: Empty input tuples

If RankIndexRankIndexRankIndexRankIndexRankIndexrankIndex is empty, the operator returns an empty tuple.

HDevelop In-line Operation

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

Selected := select_rank(Tuple, RankIndex)

Parallelization

Parameters

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

Input tuple.

RankIndexRankIndexRankIndexRankIndexRankIndexrankIndex (input_control)  number HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Rank of the element to select.

SelectedSelectedSelectedSelectedSelectedselected (output_control)  number HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Selected tuple element.

Alternatives

tuple_sort_indextuple_sort_indexTupleSortIndextuple_sort_indexTupleSortIndexTupleSortIndex, tuple_sorttuple_sortTupleSorttuple_sortTupleSortTupleSort

See also

tuple_mediantuple_medianTupleMediantuple_medianTupleMedianTupleMedian, tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect

Module

Foundation


ClassesClassesClassesClasses | | | | Operators