toArray: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *S([a-z ])" to "$1 - s$2")
 
(70 intermediate revisions by 8 users not shown)
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
____________________________________________________________________________________________


| [[toString]]<br>
|p1= string: [[String]]
[http://www.utf8-chartable.de/ Unicode Character Table] |= See also


}}
|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}}}}]]

Latest revision as of 15:49, 8 November 2023

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.
Arma 3
Since v2.04 this command can also handle HashMaps. See alternative syntax.
Groups:
ArraysHashMapStrings

Syntax 1

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

Syntax 2

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

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 toUpperANSIUnicode 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