عرض مصدر PHP/hex2bin

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

تُفك الدالة ‎<code>hex2bin()</code>‎ الترميز الست عشري للسلاسل النصية ثنائية التمثيل.

== الوصف ==
<syntaxhighlight lang="php">
‎string hex2bin(string $data)
</syntaxhighlight>تُفك الدالة ‎<code>hex2bin()</code>‎ الترميز الست عشري للسلاسل النصية ثنائية التمثيل.

تنبيه: لا تُحوِل الدالة <code>hex2bin‎()‎</code> التمثيل الست عشري للأعداد إلى التمثيل الثنائي، بل تُستَعمل الدالة <code>[[PHP/base convert|base_convert()‎]]</code> لإجراء هكذا تحويل.

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

=== <code>data</code> ===
البيانات المُرَمَّزة بالتمثيل الست عشري.

== القيم المعادة ==
تُعيد الدالة <code>hex2bin()‎</code> التمثيل الثنائي للبيانات المُدخَلة، أو القيمة ‎FALSE في حالة الفشل.

== الأخطاء والاستثناءات ==
ترمي الدالة <code>hex2bin()‎</code> الخطأ E_WARNING في حال كان طول السلسلة النصية فرديًا (odd) أو ذات تمثيل ست عشري خطأ.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.5.1
|ترمي تحذيرًا إذا كان التمثيل الست عشري للسلسلة النصية المُدخلة غير صالح.
|-
|5.4.4
|ترمي تحذيرًا في حال ما كان طول السلسلة النصية فرديًا (odd). في النسخة 5.4.0 كانت الدالة <code>hex2bin()‎</code> تقبل السلسلة النصية بصمت مع اقتطاع البايت الأخير.
|}

== أمثلة ==
المثال 1: مثال بسيط عن الدالة ‎<code>hex2bin()‎</code><syntaxhighlight lang="php">
<?php
$hex = hex2bin("6578616d706c65206865782064617461");
var_dump($hex);
?>

</syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="text">
‎string(16) "example hex data"
</syntaxhighlight>

== انظر أيضًا ==
* <code>[[PHP/bin2hex|bin2hex()‎]]</code>: تَحوِيل البيانات ثنائية التمثيل إلى التمثيل الست عشري.
* <code>[[PHP/unpack|unpack()‎]]</code>: تَفريغ البيانات من سلسلة نصية بالنظام الثنائي.

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