Arma 3 Scripting

Command in Strings, Arrays

parseSimpleArray

Also available as Markdown and JSON, or read the original wiki page.

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. This command is almost 4× faster than similar uncached call compile 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.

Note

Since Arma 3 v1.96 the command tolerates extra spaces and supports single quotes. The only recognised keywords (case insensitive) are:

  • true - translates into true
  • false - translates into false
  • nil - translates into nil
  • null - translates into nil
  • <null> - translates into nil (not objNull)
  • any - translates into nil

Syntax

parseSimpleArray stringArray

Parameters:

Returns: Array - valid array

Examples

Example 1

private _arr = parseSimpleArray "[1,2,3]";

Example 2

private _array1 = [1, "2", true, [4, "five", false]];
private _array2 = parseSimpleArray "[1,""2"",true,[4,""five"",false]]";
_array1 isEqualTo _array2; // true

Example 3

_bool = true;
_num = 123.45;
_str = "ok";
_arr = [1, false, "cool"];
_res = parseSimpleArray format ["[%1,%2,%3,%4]", _bool, _num, str _str, str _arr];
// note how _bool and _num do not need str, however if used anyway, the result in this case would be identical
hint str _res;  // returns [true,123.45,"ok",[1,false,"cool"]]

See also

set · resize · pushBack · pushBackUnique · select · apply · reverse · count · find · in · forEach · deleteAt · deleteRange · append · sort · arrayIntersect · callExtension