{"name":"parseNumber","title":"parseNumber","type":"command","url":"https://community.bistudio.com/wiki/parseNumber","revid":378867,"updated":"2026-07-30T16:48:17Z","groups":["Strings"],"status":"ok","games":{"arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma1 1.00","arma3_since":"0.50","description":"Parses the string, interpreting its content as a floating point number.\n\n> [!IMPORTANT]\n> This command does **not** work with strings representing hexadecimal numbers (e.g `\"0xCF\"`).\n>\n> ```sqf\n> parseNumber \"512 + 0x2F\"; // 512, WRONG!\n> \"512 + 0x2F\" call BIS_fnc_parseNumber // 559, CORRECT!\n> ```\n\n> [!NOTE]\n> 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.","syntaxes":[{"syntax":"parseNumber value","params":[{"name":"value","type":"String or Arma 3 v1.50 Boolean or Arma 3 v2.24 Anything","type_expr":"String | Boolean | Anything"}],"returns":{"type":"Number","type_expr":"Number","description":"the parsed number, `0` if no valid number was found; in the case of a passed Boolean, 0 if false, 1 if true"},"form":"unary","right":{"text":"value"}}],"examples":[{"text":"```sqf\n_number = parseNumber \"0.125\";            // 0.125\n_number = parseNumber \"0050\";            // 50\n_number = parseNumber \"        42 yes\";    // 42\n_number = parseNumber \"3 or 4\";            // 3\n_number = parseNumber \"either 3 or 4\";    // 0\n_number = parseNumber \"0xCF\";            // 0\n```","code":["_number = parseNumber \"0.125\";\t\t\t// 0.125\n_number = parseNumber \"0050\";\t\t\t// 50\n_number = parseNumber \"\t\t42 yes\";\t// 42\n_number = parseNumber \"3 or 4\";\t\t\t// 3\n_number = parseNumber \"either 3 or 4\";\t// 0\n_number = parseNumber \"0xCF\";\t\t\t// 0"]},{"text":"since Arma 3 v1.50:\n\n```sqf\n_result = parseNumber false;                // 0\n_result = parseNumber true;                    // 1\n_zeroOneStatus = parseNumber alive player;    // 0 if the player is dead, 1 if alive\n```","code":["_result = parseNumber false;\t\t\t\t// 0\n_result = parseNumber true;\t\t\t\t\t// 1\n_zeroOneStatus = parseNumber alive player;\t// 0 if the player is dead, 1 if alive"]},{"text":"since Arma 3 v2.24:\n\n```sqf\nparseNumber 0;                    // 0\nparseNumber 1;                     // 1\nparseNumber false;                // 0\nparseNumber true;                // 1\nparseNumber \"0\";                // 0\nparseNumber \"1\";                // 1\nparseNumber \"false\";            // 0\nparseNumber \"true\";                // 1\n```","code":["parseNumber 0;\t\t\t\t\t// 0\nparseNumber 1;\t\t \t\t\t// 1\nparseNumber false;\t\t\t\t// 0\nparseNumber true;\t\t\t\t// 1\nparseNumber \"0\";\t\t\t\t// 0\nparseNumber \"1\";\t\t\t\t// 1\nparseNumber \"false\";\t\t\t// 0\nparseNumber \"true\";\t\t\t\t// 1"]}],"see_also":["BIS_fnc_parseNumber","Floating Point Number"]}