Name
tuple_str_first_ntuple_str_first_nTupleStrFirstNtuple_str_first_nTupleStrFirstNTupleStrFirstN — Cut the first characters up to position “n” out of a string tuple.
tuple_str_first_ntuple_str_first_nTupleStrFirstNtuple_str_first_nTupleStrFirstNTupleStrFirstN cuts the first characters up to position “n” out
of each string of the input tuple StringStringStringStringStringstringVal and returns them as new
strings in the output tuple SubstringSubstringSubstringSubstringSubstringsubstring (remark: the position within
strings starts with 0 for the first character of a string). The number “n”
is determined by the second input tuple PositionPositionPositionPositionPositionposition. If
PositionPositionPositionPositionPositionposition only contains one element, this element contains the number
“n”. If StringStringStringStringStringstringVal and PositionPositionPositionPositionPositionposition have got the same number of
elements, the first element of PositionPositionPositionPositionPositionposition determines the position
“n” for the first string of StringStringStringStringStringstringVal, the second element of
PositionPositionPositionPositionPositionposition does so for the second string of StringStringStringStringStringstringVal and so on.
If PositionPositionPositionPositionPositionposition contains more than one element and StringStringStringStringStringstringVal
contains only one string, tuple_str_first_ntuple_str_first_nTupleStrFirstNtuple_str_first_nTupleStrFirstNTupleStrFirstN cuts more than one
substrings out of this string. The elements of PositionPositionPositionPositionPositionposition then
determine the lengths of these substrings. If both input tuples contain more
than one element but differ in the number of elements,
tuple_str_first_ntuple_str_first_nTupleStrFirstNtuple_str_first_nTupleStrFirstNTupleStrFirstN returns an error.
Exception: Empty input tuples
If both input tuples are empty, the operator returns an empty tuple.
Similarly, if StringStringStringStringStringstringVal is empty and PositionPositionPositionPositionPositionposition is
not, the operator returns an empty tuple. In contrast, if PositionPositionPositionPositionPositionposition
is empty and StringStringStringStringStringstringVal is not, an exception is raised.
HDevelop In-line Operation
HDevelop provides an in-line operation for tuple_str_first_ntuple_str_first_nTupleStrFirstNtuple_str_first_nTupleStrFirstNTupleStrFirstN,
which can be used in an expression in the following syntax:
Substring := str_firstn(String, Position)
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Input tuple with string(s) to examine.
Input tuple with position(s) “n”.
The first characters of the string(s) up to position “n”.
tuple_str_last_ntuple_str_last_nTupleStrLastNtuple_str_last_nTupleStrLastNTupleStrLastN,
tuple_substrtuple_substrTupleSubstrtuple_substrTupleSubstrTupleSubstr,
tuple_strstrtuple_strstrTupleStrstrtuple_strstrTupleStrstrTupleStrstr,
tuple_strrstrtuple_strrstrTupleStrrstrtuple_strrstrTupleStrrstrTupleStrrstr,
tuple_strlentuple_strlenTupleStrlentuple_strlenTupleStrlenTupleStrlen,
tuple_strchrtuple_strchrTupleStrchrtuple_strchrTupleStrchrTupleStrchr,
tuple_strrchrtuple_strrchrTupleStrrchrtuple_strrchrTupleStrrchrTupleStrrchr,
tuple_splittuple_splitTupleSplittuple_splitTupleSplitTupleSplit,
tuple_environmenttuple_environmentTupleEnvironmenttuple_environmentTupleEnvironmentTupleEnvironment
Foundation