Herror ::tuple_str_bit_select (
    const HTuple &Tuple,
    const HTuple &Index,
    char *Selected
)
Herror ::tuple_str_bit_select (
    const HTuple &Tuple,
    const HTuple &Index,
    HTuple *Selected
)

Select single character or bit from a tuple.

::tuple_str_bit_select selects a single character or bit from a tuple Tuple of integer numbers and/or strings. The input parameter Index determines the character or bit position to select. Index must contain a single number. If Index contains a floating point number, this may only represent an integer value (without fraction). The result tuple Selected contains a new element for each element of Tuple. Let Index contain the number ``n'' then each element of Selected consists of the ``n-th'' character (for strings) or ``n-th'' bit (for integers) of the corresponding element of Tuple.


Parameters

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

Index (input_control)
number -> HTuple.long / double
Position of character or bit to select.

Selected (output_control)
number(-array) -> (HTuple.) char * / long *
Tuple containing the selected characters and bits.


Alternatives

::tuple_str_bit_select, ::tuple_select, ::tuple_first_n, ::tuple_last_n, ::tuple_concat, ::tuple_strchr, ::tuple_strrchr, ::tuple_str_first_n, ::tuple_str_last_n, ::tuple_and, ::tuple_or, ::tuple_xor, ::tuple_not


Module

Operators not requiring licensing



Copyright © 1996-2002 MVTec Software GmbH