splitString: Difference between revisions

Revision as of 13:46, 1 July 2022

Hover & click on the images for description

Description:: An SQF version of C++ strtok. Splits given ANSI string str into an array of tokens according to given delimiters. In addition, if empty string "" is used for delimiters, str is split by each character. If Unicode support is desired, see forceUnicode.
Groups:: Strings

Syntax:: str splitString delimiters
Parameters:: str: String - A string to split
: delimiters: String - one or more characters, each used as a separate delimiter.
Return Value:: Array

Example 1:: _str = "- This, is a sample string." splitString "-,. "; // ["This","is","a","sample","string"] _str joinString " "; // "This is a sample string"
Example 2:: "\A3\ui_f\data\map\vehicleicons\iconLogic_ca.paa" splitString "\."; // ["A3","ui_f","data","map","vehicleicons","iconLogic_ca","paa"]
Example 3:: "1:2:3" splitString ":"; // ["1","2","3"]
Example 4:: "Japa is the best!" splitString "" joinString " "; // "J a p a i s t h e b e s t !"
Example 5:: _cmd = currentMagazineDetail player; //"9mm 16Rnd Mag(13/16)[id/cr:10000011/0]" _cmd splitString "([ ]/:)"; //["9mm","16Rnd","Mag","13","16","id","cr","10000011","0"]
Example 7:: 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 Unicode Character Table

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

: Posted on May 17, 2016 - 14:18 (UTC)
BaerMitUmlaut: This command is unreliable/broken when it comes to some non-ASCII characters (as of Arma 3 1.58):
"Mörser" splitString "" -> ["M"," "," ","r","s","e","r"] "Mörser" splitString "ö" -> ["M","rser"] "Mörser" splitString "ä" -> ["M"," rser"]

: Posted on October 17, 2016 - 14:03 (UTC)
Killzone Kid: 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 " "; // M ö r s e r

: Posted on July 19, 2019 - 11:17 (UTC)
R3vo: When working with string which contain linebreaks...
"stringWith" + endl + "Linebreak" splitString ",; "; //Result ["someStringWith Linebreak"]
...one can remove those by adding endl as delimiter
"stringWith" + endl + "Linebreak" splitString ",; " + endl //Result ["someStringWith","Linebreak"]

@@ Line 30: / Line 30: @@
 <sqf>loadFile "somefile.txt" splitString toString [13,10] joinString " "</sqf>
-|seealso= ‎[[joinString]] [[set]] [[resize]], [[reverse]], [[select]], [[in]], [[find]], [[toArray]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[toString]], [[endl]], [[forceUnicode]], [http://www.utf8-chartable.de/ Unicode Character Table]
+|seealso= ‎[[joinString]] [[set]] [[resize]] [[reverse]], [[select]], [[in]], [[find]], [[toArray]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[toString]], [[endl]], [[forceUnicode]], [http://www.utf8-chartable.de/ Unicode Character Table]
 }}