parseInt
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
parseInt(string, radix) 解析一个字符串并返回指定基数的十进制整数,radix
是 2-36 之间的整数,表示被解析字符串的基数。
尝试一下
语法
parseInt(string, radix);
参数
string
-
要被解析的值。如果参数不是一个字符串,则将其转换为字符串 (使用
ToString
抽象操作)。字符串开头的空白符将会被忽略。 radix
_ 可选_-
从
2
到36
的整数,表示进制的基数。例如指定16
表示被解析值是十六进制数。如果超出这个范围,将返回NaN
。假如指定0
或未指定,基数将会根据字符串的值进行推算。注意,推算的结果不会永远是默认值10
!文章后面的描述解释了当参数radix
不传时该函数的具体行为。
返回值
从给定的字符串中解析出的一个整数。
或者 NaN
,当
radix
小于2
或大于36
,或- 第一个非空格字符不能转换为数字。
parseInt('123', 5) // 将'123'看作 5 进制数,返回十进制数 38 => 1*5^2 + 2*5^1 + 3*5^0 = 38
描述
parseInt
函数将其第一个参数转换为一个字符串,对该字符串进行解析,然后返回一个整数或 NaN
。
如果不是 NaN
,返回值将是以第一个参数作为指定基数 radix 的转换后的十进制整数。(例如,radix
为 10
,就是可以转换十进制数,为 8
可以转换八进制数 "07",16
可以转换十六进制数"0xff",以此类推)。
对于 radix
为 10
以上的,英文字母表示大于 9
的数字。例如,对于十六进制数(基数 16
),则使用 A
到 F
。
如果 parseInt
遇到的字符不是指定 radix
参数中的数字,它将忽略该字符以及所有后续字符,并返回到该点为止已解析的整数值。parseInt
将数字截断为整数值。允许前导和尾随空格。
由于某些数字在其字符串表示形式中使用 e 字符(例如 6.022×23
表示 6.022e23
),因此当对非常大或非常小的数字使用数字时,使用 parseInt
截断数字将产生意外结果。parseInt
不应替代 Math.floor()
。
parseInt
可以理解两个符号。+
表示正数,-
表示负数(从 ECMAScript 1 开始)。它是在去掉空格后作为解析的初始步骤进行的。如果没有找到符号,算法将进入下一步;否则,它将删除符号,并对字符串的其余部分进行数字解析。
如果 radix
是 undefined
、0
或未指定的,JavaScript 会假定以下情况:
- 如果输入的
string
以0x
或0X
(一个 0,后面是小写或大写的 X)开头,那么 radix 被假定为 16,字符串的其余部分被当做十六进制数去解析。 - 如果输入的
string
以 "0
"(0)开头,radix
被假定为8
(八进制)或10
(十进制)。具体选择哪一个 radix 取决于实现。ECMAScript 5 澄清了应该使用 10 (十进制),但不是所有的浏览器都支持。因此,在使用parseInt
时,一定要指定一个 radix。 - 如果输入的
string
以任何其他值开头,radix
是10
(十进制)。
如果第一个字符不能转换为数字,parseInt
会返回 NaN
。
为了算术的目的,NaN
值不能作为任何 radix
的数字。你可以调用 isNaN
函数来确定 parseInt
的结果是否为 NaN
。如果将 NaN 传递给算术运算,则运算结果也将是 NaN
。
要将一个数字转换为特定的 radix
中的字符串字段,请使用 thatNumber.toString(radix)
函数。
示例
示例:使用 parseInt
以下例子均返回15
:
parseInt("0xF", 16);
parseInt("F", 16);
parseInt("17", 8);
parseInt(021, 8);
parseInt("015", 10);
parseInt(15.99, 10);
parseInt("15,123", 10);
parseInt("FXX123", 16);
parseInt("1111", 2);
parseInt("15 * 3", 10);
parseInt("15e2", 10);
parseInt("15px", 10);
parseInt("12", 13);
以下例子均返回 NaN
:
parseInt("Hello", 8); // 根本就不是数值
parseInt("546", 2); // 除了“0、1”外,其他数字都不是有效二进制数字
以下例子均返回 -15
:
parseInt("-F", 16);
parseInt("-0F", 16);
parseInt("-0XF", 16);
parseInt(-15.1, 10);
parseInt(" -17", 8);
parseInt(" -15", 10);
parseInt("-1111", 2);
parseInt("-15e1", 10);
parseInt("-12", 13);
下例中全部返回 4
:
parseInt(4.7, 10);
parseInt(4.7 * 1e22, 10); // 非常大的数值变成 4
parseInt(0.00000000000434, 10); // 非常小的数值变成 4
下面的例子返回 224
parseInt("0e0", 16);
没有指定 radix
参数时的八进制解析
尽管 ECMAScript 3 已经不赞成这种做法,且 ECMAScript 5 已经禁止了这种做法,但是仍然有很多实现环境仍然把以 0 开头的数值字符串(numeric string)解释为一个八进制数。下面的例子可能返回八进制的结果,也可能返回十进制的结果。总是指定一个基数(radix)可以避免这种不可靠的行为。
parseInt("0e0");
// 0
parseInt("08");
// 0, '8' 不是八进制数字。
ECMAScript 5 移除了八进制解析
ECMAScript 5 规范不再允许 parseInt
函数的实现环境把以 0
字符开始的字符串作为八进制数值。ECMAScript 5 陈述如下:
根据给定 radix,parseInt
函数产生一个由字符串参数内容解析过来的整数值。字符串中开头的空白会被忽略。如果 radix 没有指定或者为 0,参数会被假定以 10 为基数来解析,如果数值以字符对 0x 或 0X 开头,会假定以 16 为基数来解析。
这与 ECMAScript 3 有所不同,ECMAScript 3 仅仅是不提倡这种做法但并没有禁止这种做法。
直至 2013 年,很多实现环境并没有采取新的规范所规定的做法,而且由于必须兼容旧版的浏览器,所以永远都要明确给出 radix 参数的值。
一个更严格的解析函数
有时采用一个更严格的方法来解析整型值很有用。此时可以使用正则表达式:
filterInt = function (value) {
if (/^(\-|\+)?([0-9]+|Infinity)$/.test(value)) return Number(value);
return NaN;
};
console.log(filterInt("421")); // 421
console.log(filterInt("-421")); // -421
console.log(filterInt("+421")); // 421
console.log(filterInt("Infinity")); // Infinity
console.log(filterInt("421e+0")); // NaN
console.log(filterInt("421hop")); // NaN
console.log(filterInt("hop1.61803398875")); // NaN
console.log(filterInt("1.61803398875")); // NaN
规范
Specification |
---|
ECMAScript Language Specification # sec-parseint-string-radix |
浏览器兼容性
BCD tables only load in the browser