CKTIS / JavaScript
parseInt — odczytywanie liczby całkowitej z tekstu
parseInt odczytuje początkowy zapis liczby całkowitej w podanej podstawie i zwraca Number. Ignoruje dalsze niepasujące znaki, więc nie sprawdza poprawności całego tekstu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
parseInt(string, radix)parseInt(string, radix) zamienia pierwszy argument na tekst, pomija początkowe białe znaki i odczytuje opcjonalny znak + lub -, a następnie cyfry właściwe dla danej podstawy. Zwraca Number, nie BigInt. Number.parseInt oznacza tę samą funkcję języka ECMAScript, a nie osobne API przeglądarki.
Podawaj radix jawnie, zwykle jako 10. Po konwersji do 32-bitowej liczby całkowitej ze znakiem dozwolone podstawy to 2–36; inne wartości poza 0 dają NaN. Pominięta podstawa lub wartość przekształcona do 0 oznacza 10, chyba że po znaku występuje 0x lub 0X: wtedy podstawą jest 16. Prefiksy 0b i 0o nie są automatycznie rozpoznawane.
Odczyt kończy się na pierwszym niedozwolonym znaku. Dlatego parseInt("12.9", 10) daje 12, a parseInt("42px", 10) daje 42. Brak choć jednej poprawnej cyfry daje NaN; sprawdzaj go przez Number.isNaN. To parser prefiksu, nie walidator całego tekstu ani narzędzie do zaokrąglania liczb.
Duże wyniki mogą tracić precyzję typu Number. Nie używaj tej funkcji do dokładnego odczytu dowolnie dużych liczb całkowitych.
Przykłady
console.log(parseInt(" -42px", 10));
console.log(parseInt("101", 2));
console.log(parseInt("0xFF", 16));
console.log(parseInt("12.9", 10));
console.log(parseInt("0b11", 10));
console.log(Number.isNaN(parseInt("px42", 10)));Wynik
-42 5 255 12 0 true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.