BigInt.prototype.toString()

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

radix Optional

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.

Rckgabewert

Eine Zeichenkette, die den angegebenen BigInt-Wert reprsentiert.

Ausnahmen

RangeError

Wird ausgelst, wenn radix kleiner als 2 oder grer als 36 ist.

Beschreibung

Das BigInt-Objekt berschreibt die toString-Methode von Object; es erbt nicht von Object.prototype.toString(). Fr BigInt-Werte gibt die toString()-Methode eine Zeichenkettendarstellung des Wertes in der angegebenen Basis zurck.

Fr Basen ber 10 zeigen die Buchstaben des Alphabets Ziffern grer als 9 an. Zum Beispiel werden fr hexadezimale Zahlen (Basis 16) a bis f verwendet.

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

Die toString()-Methode erfordert, dass der this-Wert ein BigInt-Primitive oder -Wrapper-Objekt ist. Sie wirft einen TypeError, wenn andere this-Werte vorliegen, ohne sie in BigInt-Werte zu konvertieren.

Da BigInt keine [Symbol.toPrimitive]()-Methode besitzt, ruft JavaScript die toString()-Methode automatisch auf, wenn ein BigInt-Objekt in einem Kontext verwendet wird, der eine Zeichenkette erwartet, wie zum Beispiel in einem Template Literal. BigInt primitive Werte konsultieren jedoch die toString()-Methode nicht, um zu Zeichenketten konvertiert zu werden sie werden vielmehr direkt unter Verwendung desselben Algorithmus wie die anfngliche toString()-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 Null BigInt, 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-Kompatibilitt

Siehe auch

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