PHP/dechex

(PHP 4, PHP 5, PHP 7)

تحوِّل الدالة dechex()‎ العدد بالنظام العشري الممرَّر إليها إلى عدد ست عشري.

الوصف

string dechex ( int $number )

تعيد هذه الدالة سلسلة نصيَّة (string) تمثِّل العدد الست عشري المقابل للعدد العشري number عديم الإشارة (unsigned) الممرَّر إليها. أكبر عدد تستطيع الدالة تحويله على أنظمة 32 بت هو PHP_INT_MAX * 2 +/- 1 وهذا يقابل العدد العشري 4294967295، وعند تحويل هذا العدد باستعمال الدالة dechex()‎ فإنَّها ستُعيد العدد الست عشري ffffffff.

المعاملات

number

القيمة العدديَّة العشريَّة المراد تحويلها.

لمّا كان نوع الأعداد الصحيحة (integers) في PHP له إشارة (signed) وأنَّ الدالة dechex()‎ تتعامل مع الأعداد على أنَّها عديمة الإشارة (unsigned)، لذا ستتعامل هذه الدالة مع الأعداد السالبة على أنَّها أعداد عديمة الإشارة.

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

تُعاد سلسلة نصيَّة تمثِّل العدد الست عشري المقابل للقيمة العدديَّة number المعطاة.

أمثلة

المثال 1: استعمال الدالة dechex()‎

<?php
echo dechex(10) . "\n";
echo dechex(47);
?>

سيُظهر المثال السابق النتيجة التالية:

a
2f

المثال 2: استعمال الدالة dechex()‎ مع أعداد كبيرة وسالبة

<?php
echo dechex(-1)."\n";
echo dechex(PHP_INT_MAX * 2 + 1)."\n";
echo dechex(pow(2, 32) - 1)."\n";
?>

سيُظهر المثال السابق النتيجة التالية بفرض أنَّنا نستعمل نظامًا ذا 32 بت:

ffffffff
ffffffff
ffffffff

لاحظ أنَّ مخرجات المثال السابق هي نفسها لجميع القيم التي مُرِّرت إلى الدالة.

انظر أيضًا

• الدالة hexdec()‎: تحوِّل العدد الست عشري إلى عدد عشري.
• الدالة decoct()‎: تحوِّل العدد العشري إلى عدد ثمائي.
• الدالة decbin()‎: تحوِّل العدد العشري إلى عدد ثنائي.
• الدالة base_convert()‎: تحوِّل العدد ذو اساس ما إلى أساس آخر معيَّن.

مصادر

• صفحة الدالة dechex في توثيق PHP الرسمي.