# ParseNumber

Converts a string to a number in the specified numeral system

## Method Signature

```
ParseNumber(number=[string], locale=[string], radix=[string])
```

### Arguments

| Argument | Type     | Required | Description                                                                                                                            | Default |
| -------- | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `number` | `string` | `true`   | The string to convert to a number.                                                                                                     |         |
| `locale` | `string` | `false`  | The locale to use when parsing the number. If not provided, the system or application-configured locale is used.                       |         |
| `radix`  | `string` | `false`  | The numeral system to use for conversion (e.g., "bin", "oct", "dec", "hex"). If not provided, the number is parsed as locale-sensitive |         |

## Examples

### Convert decimal number to binary

[Run Example](https://try.boxlang.io/?code=eJwrSCwqTvUrzU1KLdJQMDQwNNBRUErKzFNS0LTmAgCF7Afm)

```java
parseNumber( 1010, "bin" );

```

Result: 10

### Convert decimal number to hex

[Run Example](https://try.boxlang.io/?code=eJwrSCwqTvUrzU1KLdJQMDQwNNBRUMpIrVBS0LTmAgCGPAfy)

```java
parseNumber( 1010, "hex" );

```

Result: 4112

### Additional Examples

[Run Example](https://try.boxlang.io/?code=eJzLK81NSi1SsFVQMjQwMFCy5kpNzsjXUAhILCpO9QPLaSjkgWkdBaWU1GQlBU0FTWsFfX0FkHq8qpMy8xCqLfAqzU8uQSg1NTTCqzgjtQKimAuk2sTA0owLAG2kODM%3D)

```java
number = "1000";
echo( ParseNumber( number, "dec" ) ); // 1000
echo( ParseNumber( number, "bin" ) ); // 8
echo( ParseNumber( number, "oct" ) ); // 512
echo( ParseNumber( number, "hex" ) );
 // 4096

```

## Related

* [DataNavigate](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/datanavigate)
* [JSONDeserialize](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/jsondeserialize)
* [JSONPrettify](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/jsonprettify)
* [JSONSerialize](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/jsonserialize)
* [LSParseNumber](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/lsparsenumber)
* [ToBase64](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/tobase64)
* [ToBinary](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/tobinary)
* [ToModifiable](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/tomodifiable)
* [ToNumeric](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/tonumeric)
* [ToScript](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/toscript)
* [ToString](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/tostring)
* [ToUnmodifiable](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/conversion/tounmodifiable)