Herror ::tuple_str_last_n (
    const HTuple &T1,
    const HTuple &T2,
    char *Substring
)
Herror ::tuple_str_last_n (
    const HTuple &T1,
    const HTuple &T2,
    HTuple *Substring
)

Cut all characters starting at position ``n'' out of string tuple.

::tuple_str_last_n cuts all characters from positiion ``n'' to the end of the string out of each string of the input tuple T1 and returns them as new strings in the output tuple Substring. The position ``n'' is determined by the second input tuple T2. If T2 only contains one element, this element contains ``n''. If T1 and T2 have got the same number of elements, the first element of T2 determines the start position for the first string of T1, the second element of T2 does so for the second string of T1 and so on. If T2 contains more than one element and T1 contains only one string, ::tuple_str_last_n cuts more than one substrings out of this string. The elements of T2 then determine the start positions for these substrings. If both input tuples contain more than one element but differ in the number of elements, ::tuple_str_last_n returns an error.


Parameters

T1 (input_control)
string(-array) -> HTuple.char *
Input tuple 1.

T2 (input_control)
number(-array) -> HTuple.long / double
Input tuple 2.

Substring (output_control)
string(-array) -> (HTuple.) char *
The last characters starting at position ``n''.


Alternatives

::tuple_str_last_n, ::tuple_strstr, ::tuple_strrstr, ::tuple_strlen, ::tuple_strchr, ::tuple_strrchr, ::tuple_split, ::tuple_environment


Module

Operators not requiring licensing



Copyright © 1996-2002 MVTec Software GmbH