CKTIS / JavaScript
Number.parseInt: ein Ganzzahlpräfix parsen
Number.parseInt wandelt das Argument in Text um und liefert die Ganzzahl aus dem längsten gültigen Präfix zur gewählten Basis oder NaN.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Number.parseInt(string, radix)Number.parseInt(value, radix) wendet zuerst ToString an, entfernt führenden Leerraum und erkennt ein optionales + oder -. radix durchläuft ToInt32: Danach wählt 0 die Vorgabe, 2..36 sind gültig und andere Werte ergeben NaN. Das Parsen endet vor der ersten für diese Basis ungültigen Ziffer; daher ergibt "15px" zur Basis 10 den Wert 15 statt eines Fehlers.
Bei vorgegebener Basis wird 10 verwendet, außer ein Präfix 0x/0X wählt 16. 0b und 0o werden hier nicht erkannt; eine explizite Basis ist für Eingaben sicherer. Wird keine gültige Ziffer verbraucht, folgt NaN; ein Ergebnis -0 behält sein Vorzeichen. Eine sehr große mathematische Ganzzahl wird als Number geliefert und kann gerundet sein.
Number.parseInt existiert seit ECMAScript 2015, ist dieselbe Funktion wie globales parseInt und kein Konstruktor. BigInt wird zuerst in Text umgewandelt und kann Genauigkeit verlieren; Symbol löst TypeError aus, während Objekte als Wert oder Basis Konvertierungscode und dessen Ausnahme ausführen können. Für eine vollständige Übereinstimmung muss der ganze Text zuerst validiert werden.
Beispiele
console.log(Number.parseInt("42", 10), Number.parseInt("0x10", 16), Number.parseInt("101", 2));
console.log(Number.parseInt("15px", 10), Number.parseInt("bad", 10));
console.log(Number.parseInt("0x10"), Number.parseInt("0x10", 10));
console.log(Object.is(Number.parseInt("-0", 10), -0), Number.parseInt === parseInt);
console.log(Number.parseInt("10", 1), Number.parseInt("10", 37));
try { Number.parseInt(Symbol("x"), 10); } catch (error) { console.log(error instanceof TypeError); }Ergebnis
42 16 5 15 NaN 16 0 true true NaN NaN true
Number.parseInt → explizite Basen, 0x-Präfix, NaN und vorzeichenbehaftetes -0