عرض مصدر PHP/base convert

<noinclude>{{DISPLAYTITLE:الدالة <code>base_convert()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تحوِّل الدالة <code>base_convert()‎</code> العدد من أساس (الأساس العشري أو الست عشري مثلًا) إلى أساس آخر معيَّن.

== الوصف ==
<syntaxhighlight lang="php">
string base_convert ( string $number , int $frombase , int $tobase )
</syntaxhighlight>تعيد هذه الدالة سلسلة نصيَّة للعدد <code>number</code> ذو الأساس <code>frombase</code> الممرَّر إلى الدالة بعد تحويله إلى الأساس <code>tobase</code>. يجب أن يتراوح مجال الأساس، سواءً للمعامل <code>frombase</code> أو المعامل <code>tobase</code>، بين 2 و 36 بحدٍّ أقصى.

تُمثَّل الأرقام المكوِّنة للعدد ذو الأساس الذي يزيد عن 10 بالأحرف a-z؛ أي أنَّ الأرقام من 0 إلى 9 تبقى نفسها وما يزاد عن ذلك يُمثَّل بأحرف. يمثِّل مثلًا الحرف a العدد 10، والحرف b العدد 11، وهكذا حتى الحرف z الذي يمثِّل العدد 35. لا تؤخذ حالة الأحرف بالحسبان، سواءً كبيرة (uppercase) أو صغيرة (lowercase)، عند تحويل أرقام العدد <code>number</code>.

تنبيه: قد تفقد الدالة <code>base_convert()‎</code> بعض الدقة عند تحويلها أعدادًا كبيرة وذلك تبعًا للخصائص المتعلقة بنوع العدد العشري المستعمل فيما إذا كان من نوع double أو float. راجع صفحة الأعداد العشرية للمزيد من المعلومات حول هذا الأمر.

== المعاملات ==

=== <code>number</code> ===
العدد المراد تحويله. سيُتجاهل أي عدد غير صالح دون ظهور أي تنبيه بذلك.

=== <code>frombase</code> ===
أساس العدد المراد تحويله.

=== <code>tobase</code> ===
الأساس الذي نريد تحويل العدد إليه.

== القيم المعادة ==
يُعاد العدد <code>number</code> ممثَّلًا بالأساس <code>tobase</code> المراد تحويله إليه.

== أمثلة ==
المثال 1: استعمال الدالة <code>base_convert()‎</code><syntaxhighlight lang="php">
<?php
$hexadecimal = 'a37334';
echo base_convert($hexadecimal, 16, 2);
?>
</syntaxhighlight>سيُظهر المثال السابق النتيجة التالية:<syntaxhighlight lang="php">
101000110111001100110100
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[PHP/intval|intval()‎]]</code>: استخلاص العدد الصحيح (integer) من متغير ما.

== مصادر ==
* [http://php.net/manual/en/function.base-convert.php صفحة الدالة base-convert في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Math]]