parseSimpleArray

From Bohemia Interactive Community
Revision as of 18:18, 25 January 2017 by Killzone Kid (talk | contribs) (see also, example)
Jump to navigation Jump to search
-wrong parameter ("arma3dev") defined!-[[:Category:Introduced with arma3dev version 1.67|1.67]]
Hover & click on the images for description

Description

Description:
Converts given, formatted as simple array, String into a valid Array. Simple array is array consisting of Numbers, Strings, Booleans and Arrays of all of the above. For example: [1,"2",true,[4,"five",false]]. The string representation of this array compatible with parseSimpleArray will be "[1,""2"",true,[4,""five"",false]]" accordingly.

This command is built for speed and security and because of this has several limitations. There is limited error reporting about format errors as the command expects well formatted array as argument. To be able to see exact format expected, you can just copy output result of str command applied to an array for reference: copyToClipboard str str [1,"2",true,[4,"five",false]] (notice the use of double str with copyToClipboard).

In any case here are the explicit rules:
  • no spaces are permitted between array elements: [1,2,3] - correct, [1, 2, 3] - incorrect!
  • only double quotes " supported for Strings: ["hello"] - correct, ['hello'] - incorrect!
  • use " to escape ", for example ["hello"] converted to string should look like this: "[""hello""]"
  • no spaces should exist before or after array brackets: "[1,2,3]" - correct, "[1,2,3] " - incorrect!
To simplify, your constructed array format should be the same as Arma array converted to string with str: _arr1 = getUnitLoadout player; _arr2 = parseSimpleArray str _arr1; hint str (_arr1 isEqualTo _arr2); //true Because of this strictness the command is on average 3x faster than similar call compile string array method. And because call compile is not required, it is also more secure and primarily intended for use with callExtension to parse the String output into Array.
Groups:
Uncategorised

Syntax

Syntax:
parseSimpleArray stringArray
Parameters:
stringArray: String - string formatted as simple array
Return Value:
Array - valid array

Examples

Example 1:
_boolean = true; _number = 123.45; _string = "ok"; _array = [1,false,"cool"]; _res = parseSimpleArray format [ "[%1,%2,%3,%4]", _boolean, _number, str _string, str _array ]; hint str _res; //[true,123.45,"ok",[1,false,"cool"]]

Additional Information

See also:
setresizepushBackpushBackUniqueselectapplyreversecountfindinforEachdeleteAtdeleteRangeappendsortarrayIntersectcallExtension

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

[[Category:Introduced with arma3dev version 1.67]][[ Category: arma3dev: New Scripting Commands | PARSESIMPLEARRAY]][[ Category: arma3dev: Scripting Commands | PARSESIMPLEARRAY]]

Notes

Bottom Section