CKTIS / JavaScript
Number.prototype.toString(radix): zapis liczby w wybranej podstawie
Zapisz wartość typu `Number` jako tekst w systemie o podstawie od 2 do 36. Zobacz, jak metoda dobiera i konwertuje podstawę oraz dlaczego formatowanie nie jest tym samym co parsowanie.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
number.toString()
number.toString(radix)Number.prototype.toString(radix) zwraca łańcuch znaków i nie zmienia liczby. radix to podstawa systemu liczbowego: 2 oznacza zapis binarny, a 16 szesnastkowy. Pominięcie argumentu lub przekazanie undefined wybiera podstawę 10. Wartość this musi być prymitywem typu Number lub obiektem Number; inna wartość, np. łańcuch znaków, powoduje TypeError.
Zgodnie z ECMAScript 2024 podany argument jest konwertowany na Number, a jego skończona część ułamkowa jest odrzucana w kierunku zera, więc "16.9" daje podstawę 16. Podstawa spoza zakresu od 2 do 36 włącznie powoduje RangeError; dotyczy to również null i NaN (sprowadzanych do zera) oraz nieskończoności. Argument typu Symbol lub BigInt powoduje TypeError podczas konwersji.
Wynik używa cyfr 0–9, a następnie małych liter a–z, bez dodawania prefiksu 0b ani 0x. Znak - nie jest zapisem w kodzie uzupełnień do dwóch, a kropka . oddziela część ułamkową. Oba zera, +0 i -0, dają "0"; wartości specjalne dają "NaN", "Infinity" i "-Infinity". W podstawie 10 możliwa jest notacja wykładnicza, np. "1e+21".
Zmiana podstawy nie odzyskuje precyzji utraconej w wartości Number. Ostatnia cyfra znacząca nie zawsze jest jednoznacznie określona, więc nie zakładaj identycznego tekstu w każdym silniku. Dla dużych liczb całkowitych wymagających dokładności używaj BigInt od początku i wywołuj BigInt.prototype.toString. parseInt(text, radix) czyta początkowy zapis liczby całkowitej, ale nie waliduje całego tekstu ani nie odtwarza części ułamkowej: parseInt("ff!", 16) zwraca 255.
Przykłady
{
const n = 255;
console.log(n.toString());
console.log(n.toString(2));
console.log(n.toString(16));
console.log(n.toString("16.9"));
console.log((-10.5).toString(2));
console.log(parseInt(n.toString(16), 16));
try {
n.toString(37);
} catch (error) {
console.log(error.name);
}
}Wynik
255 11111111 ff ff -1010.1 255 RangeError
Ta sama liczba daje zapis dziesiętny, binarny i szesnastkowy. Argument `"16.9"` wybiera podstawę `16`, ujemny ułamek zachowuje znak, a podstawa `37` powoduje `RangeError`.
Powiązane lekcje
- JavaScript · Lekcja 2 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 3 · Zaawansowany · Wersja: 4