parseInt()

Функція parseInt() парсить рядковий аргумент і повертає число в заданому radix (основа в математичних системах числення).

код для цього інтерактивного прикладу зберігається  в репозиторії  GitHub .Якщо ви хочете внести свій внесок у проект інтерактивних прикладів, будь-ласка клонуйте https://github.com/mdn/interactive-examples і присилайте нам pull request.

Синтаксис

parseInt(string, radix);

Параметри

string

Значення для парсингу. Якщо цей аргумент не рядок,тоді цей аргумент буде неявно конвертовано в рядок методом ToString . пробіли на початку аргумента ігноруються.

radix

число між 2 і 36 яке представляє radix (основу в математичних системах числення)  рядка. будьте уважні — це не по замовчуванню 10.

пис нижче  поясює більш детально що відбувається якщо radix не вказано.

Повернене значення

Число зпарсене з заданого рядка (string). Якщо radix менше 11, і перший не пробільний символ не може бути конвертований в число, то буде повернуто NaN .

Опис

Функція parseInt конвертує перший аргумент в рядок, парсить рядок, потім повертає число або NaN.

Якщо не NaN, повернене значення буде числом, яке є першим аргументом перетвореним  вказаним radix. (Наприклад,  radix  10 перетворює перший аргумент в днсяткове число, 8 перетворює у вісімкове, 16 шістнадцяткове, і т.д.) Для radix більше 10, літери англійського алфавіту позначають цифри більше 9. Наприклад, для шістнадцяткових цифр (radix 16), використовують букви від A  до F .

If parseInt encounters a character that is not a numeral in the specified radix, it ignores it and all succeeding characters and returns the integer value parsed up to that point. parseInt truncates numbers to integer values. Leading and trailing spaces are allowed.

Because some numbers use the e character in their string representation (e.g. 6.022e23 for 6.022 × 10²³), using parseInt to truncate numbers will produce unexpected results when used on very large or very small numbers. parseInt should not be used as a substitute for Math.floor().

If the radix is undefined, 0, or unspecified, JavaScript assumes the following:

1. If the input string begins with "0x" or "0X" (a zero followed by lowercase or uppercase X), radix is assumed to be 16 and the rest of the string is parsed as a hexidecimal number.
2. If the input string begins with "0" (a zero), radix is assumed to be 8 (octal) or 10 (decimal). Exactly which radix is chosen is implementation-dependent. ECMAScript 5 clarifies that 10 (decimal) should be used, but not all browsers support this yet. For this reason always specify a radix when using parseInt.
3. If the input string begins with any other value, the radix is 10 (decimal).

If the first character cannot be converted to a number, parseInt returns NaN unless the radix is bigger than 10.

For arithmetic purposes, the NaN value is not a number in any radix. You can call the isNaN function to determine if the result of parseInt is NaN. If NaN is passed on to arithmetic operations, the operation result will also be NaN.

To convert a number to its string literal in a particular radix, use thatNumber.toString(radix).

parseInt converts a BigInt to a Number and loses precision in the process because trailing non-numeric values, including "n", are discarded.

Приклади

Вживання parseInt

Всі приклади показані повертають 15:

parseInt('0xF', 16);
parseInt('F', 16);
parseInt('17', 8);
parseInt(021, 8);
parseInt('015', 10);   // but parseInt(015, 10); will return 13
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); // Not a number at all
parseInt('546', 2);   // Digits other than 0 or 1 are invalid for binary radix

Всі приклади показані повертають  -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); // Very large number becomes 4
parseInt(0.00000000000434, 10); // Very small number becomes 4

Всі приклади показані повертають  224:

parseInt('0e0', 16);

BigInt values lose precision:

parseInt(900719925474099267n)
// 900719925474099300

parseInt doesn't work with numeric separators:

parseInt('123_456');
// 123

Octal interpretations with no radix

Although discouraged by ECMAScript 3 and forbidden by ECMAScript 5, many implementations interpret a numeric string beginning with a leading 0 as octal. The following may have an octal result, or it may have a decimal result.  Always specify a radix to avoid this unreliable behavior.

parseInt('0e0'); // 0
parseInt('08'); // 0, '8' is not an octal digit.

ECMAScript 5 removes octal interpretation

The ECMAScript 5 specification of the function parseInt no longer allows implementations to treat Strings beginning with a 0 character as octal values. ECMAScript 5 states:

The parseInt function produces an integer value dictated by interpretation of the contents of the string argument according to the specified radix. Leading white space in string is ignored. If radix is undefined or 0, it is assumed to be 10 except when the number begins with the character pairs 0x or 0X, in which case a radix of 16 is assumed.

This differs from ECMAScript 3, which discouraged but allowed octal interpretation.

Many implementations have not adopted this behavior as of 2013, and because older browsers must be supported, always specify a radix.

A stricter parse function

It is sometimes useful to have a stricter way to parse integers. Regular expressions can help:

function filterInt(value) {
  if (/^[-+]?(\d+|Infinity)$/.test(value)) {
    return Number(value);
  } else {
    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

Specifications

Browser compatibility

See also

• parseFloat()
• Number.parseFloat()
• Number.parseInt()
• isNaN()
• Number.toString()
• Object.valueOf