tuple_splittuple_splitTupleSplitTupleSplit (Operator)

Name

tuple_splittuple_splitTupleSplitTupleSplit — Split strings into substrings using predefined separator symbol(s).

Signature

tuple_split( : : String, Separator : Substrings)

tuple_splittuple_splitTupleSplitTupleSplitTupleSplit searches within the strings of the input tuple StringStringStringStringstringVal for one or more separators defined in the input tuple SeparatorSeparatorSeparatorSeparatorseparator. tuple_splittuple_splitTupleSplitTupleSplitTupleSplit then splits the examined strings into the substrings divided by the separators. Both input tuples may only consist of strings. Otherwise tuple_splittuple_splitTupleSplitTupleSplitTupleSplit returns an error. If the elements of SeparatorSeparatorSeparatorSeparatorseparator contain more than one character, each character defines a separator. If StringStringStringStringstringVal consists only of one string, this is split up several times according to the elements of SeparatorSeparatorSeparatorSeparatorseparator. For example: If StringStringStringStringstringVal consists of the string “data1;data2:7;data3” and SeparatorSeparatorSeparatorSeparatorseparator contains the strings “;” and “:;”, the output tuple SubstringsSubstringsSubstringsSubstringssubstrings will comprise the strings “data1”, “data2:7”, “data3” as the result of splitting the string of StringStringStringStringstringVal according to the first element of SeparatorSeparatorSeparatorSeparatorseparator and “data1”, “data2”, “7” and “data3” as the result of splitting according to the second element of SeparatorSeparatorSeparatorSeparatorseparator. If both input tuples show the same number of elements, the search is done elementwise. I.e., tuple_splittuple_splitTupleSplitTupleSplitTupleSplit will split the first string of StringStringStringStringstringVal according to the separators in the first element of SeparatorSeparatorSeparatorSeparatorseparator, the second string of StringStringStringStringstringVal according to the separators in the second element of SeparatorSeparatorSeparatorSeparatorseparator and so on. If SeparatorSeparatorSeparatorSeparatorseparator only contains one string, the separators defined in this string will be used to split up all the strings of StringStringStringStringstringVal. If both input tuples contain more than one element and the number of elements differs for the input tuples, tuple_splittuple_splitTupleSplitTupleSplitTupleSplit returns an error. Subsequent occurences of SeparatorSeparatorSeparatorSeparatorseparator in StringStringStringStringstringVal are treated as one separator. Separators at the beginning and the end of StringStringStringStringstringVal are ignored.

For general information about string operations see Tuple / String Operations.

Exception: Empty input tuples

If either or both of the input tuples are empty, the operator returns an empty tuple.

HDevelop In-line Operation

HDevelop provides an in-line operation for tuple_splittuple_splitTupleSplitTupleSplitTupleSplit, which can be used in an expression in the following syntax:

Substrings := split(String, Separator)

Execution Information

Multithreading type: independent (runs in parallel even with exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.