JavaScript/Number/toString

الدالة Number.prototype.toString()‎ تُعيد سلسلةً نصيةً تُمثِّل الكائن Number المُحدَّد.

البنية العامة

numObj.toString([radix])

radix

عدد صحيح بين 2 و 36 الذي يُمثِّل أساس القيمة العددية المحتواة في السلسلة النصية؛ لاستخدام نظام العد العشري (decimal) شائع الاستخدام بين البشر فحدِّد القيمة 10

القيمة المعادة

سلسلة نصيّة تُمثِّل الكائن Number.

الاستثناءات

RangeError

سيرمى هذا الاستثناء إذا لم تكن قيمة الوسيط radix بين 2 و 36.

الوصف

الكائن Number يُعيد تعريف الدالة toString الموجودة في الكائن Object؛ فهو لا يرث الدالة Object.prototype.toString()‎. فلكائنات Number ستُعيد الدالة toString تمثيلًا نصيًا للكائن بالأساس العددي (radix) المُحدَّد.

الدالة toString تُفسِّر الوسيط المُمرَّر إليها، وستحاول إعادة تمثيل نصي للعدد بالأساس العددي (radix أو base) المُحدَّد. وإذا كان الأساس العددي أكبر من 10، فستستعمل الأحرف الهجائية لتمثيل الأرقام الأكبر من 9؛ فلو كان الأساس هو 16 (أي نريد تمثيل العدد بنظام العد الست عشري)، فستُستخدَم الأحرف من a إلى f.

إذا لم تُحدَّد قيمة الأساس العددي (الوسيط radix) فستُعدّ القيمة المُفضَّلة هي 10 (نظام العد العشري).

إذا كانت قيمة الكائن numObj سالبةً، فستحافظ هذه الدالة على الإشارة، حتى لو كان الأساس العددي هو 2، فستكون السلسلة النصية الناتجة هي التمثيل الثنائي للعدد الموجب ويسبقه إشارة -، وليس المتمم الثنائي (two's complement) لقيمة الكائن numObj.

إذا لم تكن قيمة الكائن numObj عددًا صحيحًا؛ فسيوضع رمز النقطة . لفصل المنازل العشرية عن العدد.

أمثلة

var count = 10;

console.log(count.toString());    // '10'
console.log((17).toString());     // '17'
console.log((17.2).toString());   // '17.2'

var x = 6;

console.log(x.toString(2));       // '110'
console.log((254).toString(16));  // 'fe'

console.log((-10).toString(2));   // '-1010'
console.log((-0xff).toString(2)); // '-11111111'

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

مصادر ومواصفات

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.
• معيار ECMAScript 1st Edition.