splitString: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]3(\|.*)\]\]" to "{{GameCategory|arma3|Scripting Commands}}") |
Lou Montana (talk | contribs) m (Text replacement - "_{10,} " to "") |
||
Line 1: | Line 1: | ||
{{Command|Comments= | {{Command|Comments= | ||
| arma3|Game name= | | arma3|Game name= | ||
Line 7: | Line 6: | ||
|gr1= Strings |GROUP1= | |gr1= Strings |GROUP1= | ||
| 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]]. |DESCRIPTION= | | 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]]. |DESCRIPTION= | ||
| str '''splitString''' delimiters |SYNTAX= | | str '''splitString''' delimiters |SYNTAX= | ||
Line 17: | Line 14: | ||
|p2= delimiters: [[String]] - one or more characters, each used as a separate delimiter. |PARAMETER2= | |p2= delimiters: [[String]] - one or more characters, each used as a separate delimiter. |PARAMETER2= | ||
| [[Array]] |RETURNVALUE= | | [[Array]] |RETURNVALUE= | ||
|x1= <code>_str = "- This, is a sample string." [[splitString]] "-,. "; // ["This","is","a","sample","string"] | |x1= <code>_str = "- This, is a sample string." [[splitString]] "-,. "; // ["This","is","a","sample","string"] | ||
Line 33: | Line 29: | ||
|x7= Remove all \r\n from file:<code>[[loadFile]] "somefile.txt" [[splitString]] [[toString]] [13,10] [[joinString]] " "</code>|EXAMPLE7= | |x7= Remove all \r\n from file:<code>[[loadFile]] "somefile.txt" [[splitString]] [[toString]] [13,10] [[joinString]] " "</code>|EXAMPLE7= | ||
| [[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] |SEEALSO= |
Revision as of 03:59, 17 January 2021
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
- 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
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:
- joinStringsetresizereverseselectinfindtoArrayforEachcountdeleteAtdeleteRangeappendsortparamparamsarrayIntersecttoStringendlforceUnicodeUnicode Character Table
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
Notes
Bottom Section
- 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"]