splitString: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|seealso= ([^ ]+)\]\], *\[\[" to "|seealso= $1]] [[")
m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(14 intermediate revisions by the same user not shown)
Line 6: Line 6:
|gr1= Strings
|gr1= Strings


|descr= An SQF version of C++ [http://www.cplusplus.com/reference/cstring/strtok/ 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]].
|descr= Splits the provided '''ANSI''' string into an array of tokens according to given delimiters.
{{Feature|informative|For Unicode support, see [[forceUnicode]].}}


|s1= str [[splitString]] delimiters
|s1= str [[splitString]] delimiters


|p1= str: [[String]] - A string to split
|p1= str: [[String]] - the string to split
|p2= delimiters: [[String]] - one or more characters, each used as a separate delimiter.
 
|p2= delimiters: [[String]] - one or more characters, each used as a separate delimiter; if empty, ''str'' is split by each character
 
|r1= [[Array]]
|r1= [[Array]]


|x1= <sqf>_str = "- This, is a sample string." splitString "-,. "; // ["This","is","a","sample","string"]
|x1= <sqf>
_str joinString " "; // "This is a sample string"</sqf>
_str = "- This, is a sample string." splitString "-,. "; // ["This","is","a","sample","string"]
_str joinString "#"; // "This#is#a#sample#string"
</sqf>


|x2= <sqf>"\A3\ui_f\data\map\vehicleicons\iconLogic_ca.paa" splitString "\.";
|x2= <sqf>
// ["A3","ui_f","data","map","vehicleicons","iconLogic_ca","paa"]</sqf>
"\A3\ui_f\data\map\vehicleicons\iconLogic_ca.paa" splitString "\."; // ["A3","ui_f","data","map","vehicleicons","iconLogic_ca","paa"]
</sqf>


|x3= <sqf>"1:2:3" splitString ":"; // ["1","2","3"]</sqf>
|x3= <sqf>"1:2:3" splitString ":"; // ["1","2","3"]</sqf>
Line 24: Line 30:
|x4= <sqf>"Japa is the best!" splitString "" joinString " "; // "J a p a  i s  t h e  b e s t !"</sqf>
|x4= <sqf>"Japa is the best!" splitString "" joinString " "; // "J a p a  i s  t h e  b e s t !"</sqf>


|x5= <sqf>_cmd = currentMagazineDetail player; //"9mm 16Rnd Mag(13/16)[id/cr:10000011/0]"
|x5= <sqf>
_cmd splitString "([ ]/:)"; //["9mm","16Rnd","Mag","13","16","id","cr","10000011","0"]</sqf>
_cmd = currentMagazineDetail player; // "9mm 16Rnd Mag(13/16)[id/cr:10000011/0]"
_cmd splitString "([ ]/:)"; // ["9mm","16Rnd","Mag","13","16","id","cr","10000011","0"]
</sqf>


|x7= Remove all \r\n from file:
|x7= Remove all \r\n from file:
<sqf>loadFile "somefile.txt" splitString toString [13,10] joinString " "</sqf>
<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]], {{Link|http://www.utf8-chartable.de/|Unicode Character Table}} {{Link|http://www.cplusplus.com/reference/cstring/strtok/|strtok (C++)}}
}}
}}


{{Note
|user= BaerMitUmlaut
|timestamp= 20160517141800
|text= This command is unreliable/broken when it comes to some non-ASCII characters (as of {{arma3}} v1.58):
<sqf>
"Mörser" splitString "" // -> ["M"," "," ","r","s","e","r"]
"Mörser" splitString "ö" // -> ["M","rser"]
"Mörser" splitString "ä" // -> ["M"," rser"]
</sqf>
}}


<dl class="command_description">
{{Note
 
|user= Killzone_Kid
<dt></dt>
|timestamp= 20161017140300
<dd class="notedate">Posted on May 17, 2016 - 14:18 (UTC)</dd>
|text= 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:
<dt class="note">[[User:BaerMitUmlaut|BaerMitUmlaut]]</dt>
<dd class="note">
This command is unreliable/broken when it comes to some non-ASCII characters (as of Arma 3 1.58):
<sqf>"Mörser" splitString ""
-> ["M"," "," ","r","s","e","r"]
"Mörser" splitString "ö"
-> ["M","rser"]
"Mörser" splitString "ä"
-> ["M"," rser"]</sqf>
</dd>
 
<dt><dt>
<dd class="notedate">Posted on October 17, 2016 - 14:03 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dd class="note"> 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:
<sqf>_spaced = toArray "Mörser" apply {toString [_x]} joinString " "; // M ö r s e r</sqf>
<sqf>_spaced = toArray "Mörser" apply {toString [_x]} joinString " "; // M ö r s e r</sqf>
</dd>
}}


<dt><dt>
{{Note
<dd class="notedate">Posted on July 19, 2019 - 11:17 (UTC)</dd>
|user= R3vo
<dt class="note">[[User:R3vo|R3vo]]</dt>
|timestamp= 20190719111700
<dd class="note">
|text= When working with string which contain linebreaks...
When working with string which contain linebreaks...
<sqf>
<sqf>"stringWith" + endl + "Linebreak" splitString ",; "; //Result ["someStringWith
"stringWith" + endl + "Linebreak" splitString ",; ";
Linebreak"]</sqf>
/*
result is ["someStringWith
Linebreak"]
*/
</sqf>


...one can remove those by adding [[endl]] as delimiter
...one can remove those by adding [[endl]] as delimiter
<sqf>"stringWith" + endl + "Linebreak" splitString ",; " + endl //Result ["someStringWith","Linebreak"]</sqf>
<sqf>"stringWith" + endl + "Linebreak" splitString ",; " + endl; // result is ["someStringWith","Linebreak"]</sqf>
</dd>
}}
 
</dl>

Latest revision as of 19:42, 3 September 2024

Hover & click on the images for description

Description

Description:
Splits the provided ANSI string into an array of tokens according to given delimiters.
For Unicode support, see forceUnicode.
Groups:
Strings

Syntax

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
Return Value:
Array

Examples

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 " ";

Additional Information

See also:
joinString set resize reverse select in find toArray forEach count deleteAt deleteRange append sort param params arrayIntersect toString endl forceUnicodeUnicode Character Table strtok (C++)

Notes

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
BaerMitUmlaut - c
Posted on May 17, 2016 - 14:18 (UTC)
This command is unreliable/broken when it comes to some non-ASCII characters (as of Arma 3 v1.58):
"Mörser" splitString "" // -> ["M"," "," ","r","s","e","r"] "Mörser" splitString "ö" // -> ["M","rser"] "Mörser" splitString "ä" // -> ["M"," rser"]
Killzone_Kid - c
Posted on Oct 17, 2016 - 14:03 (UTC)
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
R3vo - c
Posted on Jul 19, 2019 - 11:17 (UTC)
When working with string which contain linebreaks...
"stringWith" + endl + "Linebreak" splitString ",; "; /* result is ["someStringWith Linebreak"] */
...one can remove those by adding endl as delimiter
"stringWith" + endl + "Linebreak" splitString ",; " + endl; // result is ["someStringWith","Linebreak"]