|
|
|
GPP2 contains a new statement that allows splitting a string into sub-strings. Note - this is not a function and cannot be used in expressions. However, it is described here because it is part of the GPP2 string manipulation package.
STR_SPLIT <str-expr1> <str-expr2> var1, var2 ...;
The first string expression is the string to be split. It can be any string expression.
The second string expression is the delimiter sub-string. That delimiter will be used to break the first string into sub-strings. It may be any string expression and contain any number of characters (although one character is the typical delimiter).
After these two expressions comes a list of string variables, where the resulting sub-strings will be stored. At least two variables must be provided. Array members may be used (but not full arrays).
STR_SPLIT will break the source string into smaller sub-strings (based on the delimiter) and will store them in the target variables. It will use the following rules:
Delimiter characters that are used to separate sub-strings are removed and not copied to any target variable.
If the delimiter is not found at all in the source string, the entire string will be copied to the first target variable.
If not enough target variables are provided (too many delimiters found), the "rest" of the source string will be copied to the last target variable (including "unused" delimiters).
If too many target variables are provided, the rest of them will be assigned empty strings.
STR_SPLIT "abc/def" "/" var1 var2; // var1 = "abc", var2 = "def"
STR_SPLIT "abcdef" "/" var1 var2; // var1 = "abcdef", var2 = ""
STR_SPLIT "ab/cd/ef" "/" var1 var2; // var1 = "ab", var2 = "cd/ef"
STR_SPLIT "abc/def" "/" v1 v2 v3; // v1 = "abc", v2 = "def", v3 = ""
STR_SPLIT "abc||def" "||" var1 var2; // var1 = "abc", var2 = "def"
|
