toArray: Difference between revisions

Latest revision as of 15:49, 8 November 2023

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:: Arrays HashMap Strings

Syntax 1

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

2.04

Syntax 2

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

2.04

Syntax 3

Syntax:

hashMap toArray splitArrays

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"];
Example 3:: private _hashmap = ["cow", "cat", "chicken"] createHashMapFromArray [10000, 20000, 20000]; _hashmap toArray true; // returns [["cow", "cat", "chicken"], [10000, 20000, 20000]] - same as Syntax 2 _hashmap toArray false; // returns [["cow", 10000], ["cat", 20000], ["chicken", 20000]]

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: @@
-{{Command|= Comments
+{{RV|type=command
-____________________________________________________________________________________________
-| arma |= Game name
+|game1= arma1
+|version1= 1.09
-|1.09|= Game version
+|game2= arma2
-____________________________________________________________________________________________
+|version2= 1.00
-| Converts the supplied [[String]] into an [[Array]] of [[Number|Numbers]]. <br>
+|game3= arma2oa
-The numbers in the created array are the decimal [http://en.wikipedia.org/wiki/Unicode Unicode] representations of characters.
+|version3= 1.50
-|= Description
+|game4= tkoh
-____________________________________________________________________________________________
+|version4= 1.00
-| '''toArray''' string |= Syntax
+|game5= arma3
+|version5= 0.50
-|p1= string: [[String]] |= Parameter 1
+|gr1= Arrays
+|gr2= HashMap
+|gr3= Strings
-| [[Array]] |= Return value
+|descr= Converts the supplied [[String]] into an [[Array]] of [[Number]]s. The numbers in the created array are the decimal {{Link|https://en.wikipedia.org/wiki/Unicode|Unicode}} representations of characters.
-____________________________________________________________________________________________
+{{Feature|arma3|Since v2.04 this command can also handle [[HashMap]]s. See alternative syntax.}}
-|x1= <code>[[hint]] format["%1",toArray("AaŒ")]</code> returns "[65,97,338]"|= Example 1
+|s1= [[toArray]] string
-____________________________________________________________________________________________
-| [[set]], [[resize]], [[reverse]], [[select]], [[in]], [[find]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]], [http://www.utf8-chartable.de/ Unicode Character Table] |= See also
+|p1= string: [[String]]
-}}
+|r1= [[Array]]
+|s2= [[toArray]] hashMap
+|s2since= arma3 2.04
+|p21= hashMap: [[HashMap]]
+|r2= [[Array]] - array in format <nowiki>[</nowiki>[key, key, ...], [value, value, ...]]
+|s3= hashMap [[toArray]] splitArrays
+|s3since= arma3 2.04
+|p41= hashMap: [[HashMap]]
+|p42= splitArrays: [[Boolean]] - see return value
+|r3= [[Array]] - array in either one of the following formats:
+* splitArrays: [[true]] - {{hl|[<nowiki/>[key1, key2, ...], [value1, value2, ...]]}}
+* splitArrays: [[false]] - {{hl|[<nowiki/>[key1, value1], [key2, value2], ...]}} This is '''very inefficient''' since the engine has to create many small arrays
+|x1= <sqf>hint format ["%1", toArray "AaŒ"];// Returns "[65,97,338]"</sqf>
-<h3 style="display:none">Notes</h3>
+|x2= <sqf>toArray _hashMap params ["_keys", "_values"];</sqf>
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
+|x3= <sqf>
-</dl>
+private _hashmap = ["cow", "cat", "chicken"] createHashMapFromArray [10000, 20000, 20000];
+_hashmap toArray true;	// returns [["cow", "cat", "chicken"], [10000, 20000, 20000]] - same as Syntax 2
+_hashmap toArray false;	// returns [["cow", 10000], ["cat", 20000], ["chicken", 20000]]
+</sqf>
-<h3 style="display:none">Bottom Section</h3>
+|seealso= [[set]] [[resize]] [[reverse]] [[select]] [[in]] [[find]] [[toString]] [[count]] [[deleteAt]] [[splitString]] [[joinString]] [[toUpperANSI]], {{Link|http://www.utf8-chartable.de/|Unicode Character Table}}
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
+}}
-[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
-[[Category:Command_Group:_Variables|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]