Herror ::tuple_select_range (
    const HTuple &Tuple,
    const HTuple &Leftindex,
    const HTuple &Rightindex,
    long *Selected
)
Herror ::tuple_select_range (
    const HTuple &Tuple,
    const HTuple &Leftindex,
    const HTuple &Rightindex,
    HTuple *Selected
)

Select several elements of a tuple.

::tuple_select_range selects several consecutive elements of the input tuple Tuple and returns them with Selected. At this, Leftindex determines the index of the first element and Rightindex determines the index of the last element to select. Thus both parameters Leftindex and Rightindex must contain a single integer value (any floating point number 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. The result tuple Selected contains every element from the tuple Tuple that has got an index between Leftindex and Rightindex (including the elements at position Leftindex and Rightindex). The index Rightindex must be greater or equal to Leftindex. If the parameters contain equal values, only one element is selected.


Parameters

Tuple (input_control)
number(-array) -> HTuple.long / double / char *
Input tuple.

Leftindex (input_control)
number(-array) -> HTuple.long / double
Index of first element to select.

Rightindex (input_control)
number(-array) -> HTuple.long / double
Index of last element to select.

Selected (output_control)
number(-array) -> (HTuple.) long * / double * / char *
Selected tuple elements.


Alternatives

::tuple_select, ::tuple_first_n, ::tuple_last_n, ::tuple_str_bit_select, ::tuple_concat


Module

Operators not requiring licensing



Copyright © 1996-2002 MVTec Software GmbH