| Operators |
tuple_substr — Cut characters from position “n1” through “n2” out of a string tuple.
tuple_substr cuts all characters from position “n1” through “n2” out of each string of the input tuple String and returns them as new strings in the output tuple Substring. The positions “n1” and “n2” are determined by the second and third input tuples Position1 and Position2. Their length has to be equal. If Position1 and Position2 only contain one element, this element defines for all strings of String “n1” and “n2”, respectively . If String, Position1 and Position2 have got the same number of elements, the first elements of Position1 and Position2 determine the start and end position for the first string of String. The second elements of Position1 and Position2 do so for the second string of String and so on. If Position1 and Position2 contain more than one element and String contains only one string, tuple_substr cuts more than one substring out of this string. The elements of Position1 and Position2 then determine the start and end positions for these substrings. If all input tuples contain more than one element but differ in the number of elements, tuple_substr returns an error.
For general information about string operations see Tuple / String Operations.
If String is an empty tuple, the operator returns an empty tuple. If String is not empty and Position1 and/or Position2 are empty tuples, an exception is raised.
HDevelop provides an in-line operation for tuple_substr, which can be used in an expression in the following syntax:
Substring := String{Position1:Position2}
Input tuple with string(s) to examine.
Input tuple with start position(s) “n1”.
Input tuple with end position(s) “n2”.
Characters of the string(s) from position “n1” to “n2”.
tuple_str_first_n, tuple_str_last_n, tuple_strstr, tuple_strrstr, tuple_strlen, tuple_strchr, tuple_strrchr, tuple_split, tuple_environment
Foundation
| Operators |