NumberParser (hutool 6.0.0-M20 API)

java.lang.Object
- org.dromara.hutool.core.math.NumberParser

```
public class NumberParser
extends Object
```
数字解析器
用于将字符串解析为对应的数字类型，支持包括：
- 0开头的忽略开头的0
- 空串返回0
- NaN返回0
- 其它情况按照10进制转换
- .123形式返回0.123（按照小于0的小数对待）
构造时可选是否将NaN转为0，默认为true。
参考：https://stackoverflow.com/questions/5876369/why-does-casting-double-nan-to-int-not-throw-an-exception-in-java
Since:

6.0.0

Author:

looly

Field Summary

Fields
Modifier and Type Field and Description

static NumberParser INSTANCE
单例

Fields
Modifier and Type	Field and Description
`static NumberParser`	`INSTANCE` 单例

Constructor Summary

Constructors
Constructor and Description

NumberParser(Locale locale, boolean zeroIfNaN)
构造

Constructors
Constructor and Description
`NumberParser(Locale locale, boolean zeroIfNaN)` 构造

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static NumberParser`	`of(Locale locale)` 构建NumberParser
`static NumberParser`	`of(Locale locale, boolean zeroIfNaN)` 构建NumberParser
`BigInteger`	`parseBigInteger(String str)` 解析为`BigInteger`，支持16进制、10进制和8进制，如果传入空白串返回null from Apache Common Lang
`double`	`parseDouble(String numberStr)` 解析转换数字字符串为long型数字，规则如下： 1、0开头的忽略开头的0 2、空串返回0 3、其它情况按照10进制转换 4、.123形式返回0.123（按照小于0的小数对待） 5、NaN返回0
`float`	`parseFloat(String numberStr)` 解析转换数字字符串为long型数字，规则如下： 1、0开头的忽略开头的0 2、空串返回0 3、其它情况按照10进制转换 4、.123形式返回0.123（按照小于0的小数对待）
`int`	`parseInt(char[] chars, int radix)` 转换char数组为一个int值，此方法拷贝自`Integer.parseInt(String, int)` 拷贝的原因是直接转换char[]避免创建String对象造成的多余拷贝此方法自动跳过首尾空白符
`int`	`parseInt(String numberStr)` 解析转换数字字符串为int型数字，规则如下： 1、0x开头的视为16进制数字 2、0开头的忽略开头的0 3、其它情况按照10进制转换 4、空串返回0 5、.123形式返回0（按照小于0的小数对待） 6、123.56截取小数点之前的数字，忽略小数部分 7、科学计数法抛出NumberFormatException异常
`long`	`parseLong(String numberStr)` 解析转换数字字符串为long型数字，规则如下： 1、0x开头的视为16进制数字 2、0开头的忽略开头的0 3、空串返回0 4、其它情况按照10进制转换 5、.123形式返回0（按照小于0的小数对待） 6、123.56截取小数点之前的数字，忽略小数部分
`Number`	`parseNumber(String numberStr)` 将指定字符串转换为`Number` 对象此方法不支持科学计数法空白符和NaN转换为0 0x开头使用16进制解析为Long类型需要注意的是，在不同Locale下，数字的表示形式也是不同的，例如：德国、荷兰、比利时、丹麦、意大利、罗马尼亚和欧洲大多地区使用`,`区分小数也就是说，在这些国家地区，1.20表示120，而非1.2。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - INSTANCE
```
public static final NumberParser INSTANCE
```
    单例
- Constructor Detail
  - NumberParser
```
public NumberParser(Locale locale,
                    boolean zeroIfNaN)
```
    构造
    
    Parameters:
    
    locale - 地域，null表示默认本地
    
    zeroIfNaN - 如果用户传入NaN，是否转为0，如果为false，则抛出NumberFormatException
- Method Detail
  - of
```
public static NumberParser of(Locale locale)
```
    构建NumberParser
    
    Parameters:
    
    locale - 地域，null表示默认本地
    
    Returns:
    
    NumberParser
  - of
```
public static NumberParser of(Locale locale,
                              boolean zeroIfNaN)
```
    构建NumberParser
    
    Parameters:
    
    locale - 地域，null表示默认本地
    
    zeroIfNaN - 如果用户传入NaN，是否转为0，如果为false，则抛出NumberFormatException
    
    Returns:
    
    NumberParser
  - parseInt
```
public int parseInt(String numberStr)
             throws NumberFormatException
```
    解析转换数字字符串为int型数字，规则如下：
```
 1、0x开头的视为16进制数字
 2、0开头的忽略开头的0
 3、其它情况按照10进制转换
 4、空串返回0
 5、.123形式返回0（按照小于0的小数对待）
 6、123.56截取小数点之前的数字，忽略小数部分
 7、科学计数法抛出NumberFormatException异常
 
```
    Parameters:
    
    numberStr - 数字字符串
    
    Returns:
    
    int
    
    Throws:
    
    NumberFormatException - 数字格式异常
  - parseInt
```
public int parseInt(char[] chars,
                    int radix)
```
    转换char数组为一个int值，此方法拷贝自Integer.parseInt(String, int)
    拷贝的原因是直接转换char[]避免创建String对象造成的多余拷贝
    此方法自动跳过首尾空白符
    
    Parameters:
    
    chars - char数组
    
    radix - 进制数
    
    Returns:
    
    int值
    
    See Also:
    
    Integer.parseInt(String, int)
  - parseLong
```
public long parseLong(String numberStr)
```
    解析转换数字字符串为long型数字，规则如下：
```
 1、0x开头的视为16进制数字
 2、0开头的忽略开头的0
 3、空串返回0
 4、其它情况按照10进制转换
 5、.123形式返回0（按照小于0的小数对待）
 6、123.56截取小数点之前的数字，忽略小数部分
 
```
    Parameters:
    
    numberStr - 数字字符串
    
    Returns:
    
    long
  - parseFloat
```
public float parseFloat(String numberStr)
```
    解析转换数字字符串为long型数字，规则如下：
```
 1、0开头的忽略开头的0
 2、空串返回0
 3、其它情况按照10进制转换
 4、.123形式返回0.123（按照小于0的小数对待）
 
```
    Parameters:
    
    numberStr - 数字字符串
    
    Returns:
    
    long
    
    Since:
    
    5.5.5
  - parseDouble
```
public double parseDouble(String numberStr)
```
    解析转换数字字符串为long型数字，规则如下：
```
 1、0开头的忽略开头的0
 2、空串返回0
 3、其它情况按照10进制转换
 4、.123形式返回0.123（按照小于0的小数对待）
 5、NaN返回0
 
```
    Parameters:
    
    numberStr - 数字字符串
    
    Returns:
    
    double
  - parseBigInteger
```
public BigInteger parseBigInteger(String str)
```
    解析为BigInteger，支持16进制、10进制和8进制，如果传入空白串返回null
    from Apache Common Lang
    
    Parameters:
    
    str - 数字字符串
    
    Returns:
    
    BigInteger
  - parseNumber
```
public Number parseNumber(String numberStr)
                   throws NumberFormatException
```
    将指定字符串转换为Number 对象
    此方法不支持科学计数法
    - 空白符和NaN转换为0
    - 0x开头使用16进制解析为Long类型
    需要注意的是，在不同Locale下，数字的表示形式也是不同的，例如：
    德国、荷兰、比利时、丹麦、意大利、罗马尼亚和欧洲大多地区使用`,`区分小数
    也就是说，在这些国家地区，1.20表示120，而非1.2。
    Parameters:
    
    numberStr - 数字字符串
    
    Returns:
    
    Number对象
    
    Throws:
    
    NumberFormatException - 包装了ParseException，当给定的数字字符串无法解析时抛出

Class NumberParser

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

INSTANCE

Constructor Detail

NumberParser

Method Detail

of

of

parseInt

parseInt

parseLong

parseFloat

parseDouble

parseBigInteger

parseNumber