DietoString()-Methode vonBigInt-Werten gibt eine Zeichenkette zurück, die den angegebenenBigInt-Wert repräsentiert. Das abschließende "n" ist nicht Teil der Zeichenkette.

Probieren Sie es aus

console.log(1024n.toString());// Expected output: "1024"console.log(1024n.toString(2));// Expected output: "10000000000"console.log(1024n.toString(16));// Expected output: "400"

Syntax

toString()toString(radix)

Parameter

radixOptional

Ein ganzzahliger Wert im Bereich von 2 bis 36, der die Basis angibt, die zur Darstellung des BigInt-Wertes verwendet werden soll. Standardwert ist 10.

Rückgabewert

Eine Zeichenkette, die den angegebenenBigInt-Wert repräsentiert.

Ausnahmen

RangeError

Wird ausgelöst, wennradix kleiner als 2 oder größer als 36 ist.

Beschreibung

DasBigInt-Objekt überschreibt dietoString-Methode vonObject; es erbt nicht vonObject.prototype.toString(). FürBigInt-Werte gibt dietoString()-Methode eine Zeichenkettendarstellung des Wertes in der angegebenen Basis zurück.

Für Basen über 10 zeigen die Buchstaben des Alphabets Ziffern größer als 9 an. Zum Beispiel werden für hexadezimale Zahlen (Basis 16)a bisf verwendet.

Wenn der angegebene BigInt-Wert negativ ist, bleibt das Vorzeichen erhalten. Dies gilt auch, wenn die Basis 2 ist; die zurückgegebene Zeichenkette ist die positive binäre Darstellung des BigInt-Wertes, der von einem--Zeichen vorangestellt ist,nicht das Zweierkomplement des BigInt-Wertes.

DietoString()-Methode erfordert, dass derthis-Wert einBigInt-Primitive oder -Wrapper-Objekt ist. Sie wirft einenTypeError, wenn anderethis-Werte vorliegen, ohne sie in BigInt-Werte zu konvertieren.

DaBigInt keine[Symbol.toPrimitive]()-Methode besitzt, ruft JavaScript dietoString()-Methode automatisch auf, wenn einBigInt-Objekt in einem Kontext verwendet wird, der eine Zeichenkette erwartet, wie zum Beispiel in einemTemplate Literal. BigIntprimitive Werte konsultieren jedoch dietoString()-Methode nicht, um zuZeichenketten konvertiert zu werden — sie werden vielmehr direkt unter Verwendung desselben Algorithmus wie die anfänglichetoString()-Implementierung konvertiert.

BigInt.prototype.toString = () => "Overridden";console.log(`${1n}`); // "1"console.log(`${Object(1n)}`); // "Overridden"

Beispiele

Verwendung von toString()

17n.toString(); // "17"66n.toString(2); // "1000010"254n.toString(16); // "fe"(-10n).toString(2); // "-1010"(-0xffn).toString(2); // "-11111111"

Negative-Null-BigInt

Es gibt keine negative NullBigInt, da es in ganzen Zahlen keine negativen Nullen gibt.-0.0 ist ein IEEE-Gleitkomma-Konzept, das nur im JavaScript-Number-Typ auftritt.

(-0n).toString(); // "0"BigInt(-0).toString(); // "0"

Spezifikationen

Browser-Kompatibilität

Siehe auch

• BigInt.prototype.toLocaleString()
• BigInt.prototype.valueOf()
• Number.prototype.toString()