---
name: "parseNumber"
type: command
status: ok
groups: ["Strings"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/parseNumber
revid: 378867
updated: 2026-07-30T16:48:17Z
---

# parseNumber

*Command · Strings · Arma 3 v0.50 · introduced in Armed Assault v1.00*

## 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"`).
>
> ```sqf
> 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

```sqf
parseNumber value
```

**Parameters:**

- `value`: [String](../topics/String.md) or Arma 3 v1.50 [Boolean](../topics/Boolean.md) or Arma 3 v2.24 [Anything](../topics/Anything.md)

**Returns:** [Number](../topics/Number.md) - the parsed number, `0` if no valid number was found; in the case of a passed [Boolean](../topics/Boolean.md), 0 if [false](../commands/false.md), 1 if [true](../commands/true.md)

## Examples

### Example 1

```sqf
_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:

```sqf
_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:

```sqf
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](../functions/BIS_fnc_parseNumber.md) · Floating Point Number

<sub>Source: [BI Community Wiki — parseNumber](https://community.bistudio.com/wiki/parseNumber) (revision 378867).</sub>