toArray: Difference between revisions

Revision as of 15:39, 16 April 2021

1.09

Hover & click on the images for description

Description

Description:: Converts the supplied String into an Array of Numbers. The numbers in the created array are the decimal Unicode representations of characters. Template:Featuer
Groups:: Strings Arrays

Syntax 1

Syntax:: toArray string
Parameters:: string: String
Return Value:: Array

Syntax 2

Syntax:: toArray hashMap Template:Since
Parameters:: hashMap: HashMap
Return Value:: Array - Array in format [[key, key, ...], [value, value, ...]]

Syntax 3

Syntax:

hashMap toArray method Template:Since

Parameters:

hashMap: HashMap

method: Boolean - See return value

Return Value:

Array - Array in either one of the following formats:

method: true - [[key1, key2, ...], [value1, value2, ...]]
method: false - [[key1, value1], [key2, value2], ...] This is very inefficient since the engine has to create many small arrays

Examples

Example 1:: hint format ["%1", toArray "AaŒ"];// Returns "[65,97,338]"

Additional Information

See also:: set resize reverse select in find toString count deleteAt splitString joinString toUpperANSI Unicode 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

@@ Line 1: / Line 1: @@
 {{RV|type=command
-| arma1
+|game1= arma1
-|1.09
+|version1= 1.09
+|game2= arma2
+|version2= 1.00
+|game3= arma2oa
+|version3= 1.51
+|game4= tkoh
+|version4= 1.00
+|game5= arma3
+|version5= 0.50
 |gr1= Strings
@@ Line 9: / Line 25: @@
 |gr2= Arrays
-| Converts the supplied [[String]] into an [[Array]] of [[Number|Numbers]]. <br>
+|descr= Converts the supplied [[String]] into an [[Array]] of [[Number|Numbers]]. The numbers in the created array are the decimal [http://en.wikipedia.org/wiki/Unicode Unicode] representations of characters.
-The numbers in the created array are the decimal [http://en.wikipedia.org/wiki/Unicode Unicode] representations of characters.
+{{Featuer|arma3|Since v2.04 this command can also handle [[HashMap]]s. See alternative syntax.}}
-| '''toArray''' string
+|s1= '''toArray''' string
 |p1= string: [[String]]
-| [[Array]]
+|r1= [[Array]]
-|x1= <code>[[hint]] format["%1",toArray("AaŒ")]</code> returns "[65,97,338]"
+|s2= '''toArray''' hashMap {{Since|arma3|2.04|y}}
-| [[set]], [[resize]], [[reverse]], [[select]], [[in]], [[find]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]], [[toLower]], [[toUpper]], [[toFixed]], [[endl]], [[toLowerANSI]], [[toUpperANSI]], [http://www.utf8-chartable.de/ Unicode Character Table]
+|p21= hashMap: [[HashMap]]
-}}
+|r2= [[Array]] - Array in format <nowiki>[</nowiki>[key, key, ...], [value, value, ...]]
+|s3= hashMap '''toArray''' method {{Since|arma3|2.04|y}}
+|p41= hashMap: [[HashMap]]
+|p42= method: [[Boolean]] - See return value
+|r3= [[Array]] - Array in either one of the following formats:
+* method: [[true]] - {{ic|<nowiki>[</nowiki>[key1, key2, ...], [value1, value2, ...]]}}
+* method: [[false]] - {{ic|<nowiki>[</nowiki>[key1, value1], [key2, value2], ...]}} This is '''very inefficient''' since the engine has to create many small arrays
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
+|x1= <code>[[hint]] [[format]] ["%1", [[toArray]] "AaŒ"];{{cc|Returns "[65,97,338]"}}</code>
-{{GameCategory|arma1|Scripting Commands}}
-{{GameCategory|arma2|Scripting Commands}}
+|seealso= [[set]], [[resize]], [[reverse]], [[select]], [[in]], [[find]], [[toString]], [[count]], [[deleteAt]], [[splitString]], [[joinString]], [[toUpperANSI]], [http://www.utf8-chartable.de/ Unicode Character Table]
-{{GameCategory|arma3|Scripting Commands}}
+}}
-{{GameCategory|tkoh|Scripting Commands}}