Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła