База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Number.prototype.toString(radix): запис на число при избрана основа

Преобразувайте стойност от тип `Number` в текст при основа от 2 до 36. Вижте как JavaScript избира и преобразува основата и защо форматирането на число не е равнозначно на разчитане на текст.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

number.toString()
number.toString(radix)

Number.prototype.toString(radix) връща низ, без да променя числото. radix е основата на бройната система: 2 означава двоичен запис, а 16 — шестнадесетичен. При пропуснат аргумент или подадено undefined се използва основа 10. Стойността на this трябва да е примитив от тип Number или обект Number; друга стойност, например низ, предизвиква TypeError.

Според ECMAScript 2024 подаденият аргумент се преобразува в Number. Ако получената стойност е крайна, тя се отрязва към нулата, така че "16.9" избира основа 16. Основа извън диапазона от 2 до 36 включително предизвиква RangeError. Това важи и за null и NaN (които се свеждат до нула), както и за безкрайните стойности. Аргумент от тип Symbol или BigInt предизвиква TypeError при преобразуването.

Резултатът използва цифрите 0–9, последвани от малките букви a–z, без да добавя префикс 0b или 0x. Началният - е знак, а не запис в допълнителен код; точката . отделя дробната част. И +0, и -0 дават "0"; специалните стойности дават "NaN", "Infinity" и "-Infinity". При основа 10 е възможен научен запис, например "1e+21".

Смяната на основата не възстановява точността, която вече е изгубена в стойността Number. Последната значеща цифра невинаги е еднозначно определена, затова не разчитайте на еднакъв низ при всички реализации. Ако големите цели числа трябва да останат точни, използвайте BigInt от самото начало и извикайте BigInt.prototype.toString. parseInt(text, radix) разчита началната част от низа, която представлява цяло число, но не проверява целия низ и не възстановява дробната част: parseInt("ff!", 16) връща 255.

Примери

{
  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);
  }
}

Резултат

255
11111111
ff
ff
-1010.1
255
RangeError

Едно и също число се извежда в десетичен, двоичен и шестнадесетичен запис. `"16.9"` избира основа `16`, отрицателното число с дробна част запазва знака си, а основа `37` предизвиква `RangeError`.

Свързани уроци

  • JavaScript · Урок 2 · Напреднало · Версия: 4
  • JavaScript · Урок 3 · Напреднало · Версия: 4

Източници