toArray: Difference between revisions

Revision as of 14:41, 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.
Since v2.04 this command can also handle HashMaps. See alternative syntax.
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 splitArrays Template:Since

Parameters:

hashMap: HashMap

splitArrays: Boolean - See return value

Return Value:

Array - Array in either one of the following formats:

splitArrays: true - [[key1, key2, ...], [value1, value2, ...]]
splitArrays: 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]"
Example 2:: toArray _hashMap params ["_keys", "_values"];

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 26: / Line 26: @@
 |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.
-{{Featuer|arma3|Since v2.04 this command can also handle [[HashMap]]s. See alternative syntax.}}
+{{Feature|arma3|Since v2.04 this command can also handle [[HashMap]]s. See alternative syntax.}}
 |s1= '''toArray''' string
@@ Line 40: / Line 40: @@
 |r2= [[Array]] - Array in format <nowiki>[</nowiki>[key, key, ...], [value, value, ...]]
-|s3= hashMap '''toArray''' method {{Since|arma3|2.04|y}}
+|s3= hashMap '''toArray''' splitArrays {{Since|arma3|2.04|y}}
 |p41= hashMap: [[HashMap]]
-|p42= method: [[Boolean]] - See return value
+|p42= splitArrays: [[Boolean]] - See return value
 |r3= [[Array]] - Array in either one of the following formats:
-* method: [[true]] - {{ic|<nowiki>[</nowiki>[key1, key2, ...], [value1, value2, ...]]}}
+* splitArrays: [[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
+* splitArrays: [[false]] - {{ic|<nowiki>[</nowiki>[key1, value1], [key2, value2], ...]}} This is '''very inefficient''' since the engine has to create many small arrays
 |x1= <code>[[hint]] [[format]] ["%1", [[toArray]] "AaŒ"];{{cc|Returns "[65,97,338]"}}</code>
+|x2= <code>[[toArray]] _hashMap [[params]] ["_keys", "_values"];</code>
 |seealso= [[set]], [[resize]], [[reverse]], [[select]], [[in]], [[find]], [[toString]], [[count]], [[deleteAt]], [[splitString]], [[joinString]], [[toUpperANSI]], [http://www.utf8-chartable.de/ Unicode Character Table]
 }}