ClassesClasses | | Operators

tuple_sort_indextuple_sort_indexTupleSortIndexTupleSortIndex (Operator)

Name

tuple_sort_indextuple_sort_indexTupleSortIndexTupleSortIndex — Sort the elements of a tuple and return the indices of the sorted tuple.

Signature

tuple_sort_index( : : Tuple : Indices)

Herror tuple_sort_index(const Hlong Tuple, Hlong* Indices)

Herror T_tuple_sort_index(const Htuple Tuple, Htuple* Indices)

void TupleSortIndex(const HTuple& Tuple, HTuple* Indices)

HTuple HTuple::TupleSortIndex() const

static void HOperatorSet.TupleSortIndex(HTuple tuple, out HTuple indices)

HTuple HTuple.TupleSortIndex()

Description

tuple_sort_indextuple_sort_indexTupleSortIndexTupleSortIndexTupleSortIndex sorts all elements of TupleTupleTupleTupletuple in ascending order and returns the indices of the elements of the sorted tuple (in relation to the input tuple TupleTupleTupleTupletuple) with IndicesIndicesIndicesIndicesindices. As a precondition the single elements of TupleTupleTupleTupletuple must be comparable. Thus, TupleTupleTupleTupletuple must either exclusively consist of strings or it must only contain (integer or floating point) numbers. In the latter case integers and floating point numbers may be mixed.

Exception: Empty input tuple

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

HDevelop In-line Operation

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

Indices := sort_index(Tuple)

Execution Information

Parameters

TupleTupleTupleTupletuple (input_control)  number(-array) HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Input tuple.

IndicesIndicesIndicesIndicesindices (output_control)  number(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Sorted tuple.

Alternatives

tuple_sorttuple_sortTupleSortTupleSortTupleSort, tuple_inversetuple_inverseTupleInverseTupleInverseTupleInverse

Module

Foundation


ClassesClasses | | Operators