Description
Splits the provided ANSI string into an array of tokens according to given delimiters.
Note
For Unicode support, see forceUnicode.
Syntax
str splitString delimiters
Parameters:
str: String - the string to split
delimiters: String - one or more characters, each used as a separate delimiter; if empty, str is split by each character
Returns: Array of Strings
Examples
Example 1
_str = "- This, is a sample string." splitString "-,. ";
_str joinString "#";
Example 2
"\A3\ui_f\data\map\vehicleicons\iconLogic_ca.paa" splitString "\.";
Example 3
"1:2:3" splitString ":";
Example 4
"Japa is the best!" splitString "" joinString " ";
Example 5
_cmd = currentMagazineDetail player;
_cmd splitString "([ ]/:)";
Example 6
Remove all \r\n from file:
loadFile "somefile.txt" splitString toString [13,10] joinString " ";
See also
joinString · set · resize · reverse · select · in · find · toArray · forEach · count · deleteAt · deleteRange · append · sort · param · params · arrayIntersect · toString · endl · forceUnicode
This command is unreliable/broken when it comes to some non-ASCII characters (as of Arma 3 v1.58):
"Mörser" splitString ""
"Mörser" splitString "ö"
"Mörser" splitString "ä"
This commands works only with ASCII chars, any chars with codes > 127, also used in different languages, will be converted to [" ", " "]. Use toArray to preserve special characters:
_spaced = toArray "Mörser" apply {toString [_x]} joinString " ";
When working with string which contain linebreaks...
"stringWith" + endl + "Linebreak" splitString ",; ";
...one can remove those by adding endl as delimiter
"stringWith" + endl + "Linebreak" splitString ",; " + endl;