Arma 3 Scripting

Command in Strings

parseNumber

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

Description

Parses the string, interpreting its content as a floating point number.

Important

This command does not work with strings representing hexadecimal numbers (e.g "0xCF").

parseNumber "512 + 0x2F"; // 512, WRONG!
"512 + 0x2F" call BIS_fnc_parseNumber // 559, CORRECT!

Note

Starting whitespaces are discarded, then as many valid characters are used to be interpreted as a number until an invalid character is found then the rest of the string is ignored.

Syntax

parseNumber value

Parameters:

Returns: Number - the parsed number, 0 if no valid number was found; in the case of a passed Boolean, 0 if false, 1 if true

Examples

Example 1

_number = parseNumber "0.125";            // 0.125
_number = parseNumber "0050";            // 50
_number = parseNumber "        42 yes";    // 42
_number = parseNumber "3 or 4";            // 3
_number = parseNumber "either 3 or 4";    // 0
_number = parseNumber "0xCF";            // 0

Example 2

since Arma 3 v1.50:

_result = parseNumber false;                // 0
_result = parseNumber true;                    // 1
_zeroOneStatus = parseNumber alive player;    // 0 if the player is dead, 1 if alive

Example 3

since Arma 3 v2.24:

parseNumber 0;                    // 0
parseNumber 1;                     // 1
parseNumber false;                // 0
parseNumber true;                // 1
parseNumber "0";                // 0
parseNumber "1";                // 1
parseNumber "false";            // 0
parseNumber "true";                // 1

See also

BIS_fnc_parseNumber · Floating Point Number