الفرق بين المراجعتين لصفحة: «PHP/hex2bin»
< PHP
هارون-بوكرش (نقاش | مساهمات) أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة hex2bin() في PHP}}</noinclude>' |
هارون-بوكرش (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة hex2bin() في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة hex2bin() في PHP}}</noinclude> | ||
((PHP 5 >= 5.4.0, PHP 7 | |||
تُفك الدالة hex2bin() الترميز الست عشري للسلاسل النصية ثنائية التمثيل. | |||
=== الوصف === | |||
<syntaxhighlight lang="php"> | |||
string hex2bin(string $data) | |||
</syntaxhighlight>تُفك الدالة hex2bin() الترميز الست عشري للسلاسل النصية ثنائية التمثيل. | |||
==== تنبيه: لا تُحوِل الدالة hex2bin() التمثيل الست عشري للأعداد إلى التمثيل الثنائي، بل تُستَعمل الدالة base_convert() لإجراء هكذا تحويل. ==== | |||
=== المعاملات === | |||
==== data ==== | |||
البيانات المُرَمَّزة بالتمثيل الست عشري. | |||
=== القيم المعادة === | |||
تُعيد الدالة hex2bin() التمثيل الثنائي للبيانات المُدخَلة، أو القيمة FALSE في حالة الفشل. | |||
=== الأخطاء والاستثناءات === | |||
ترمي الدالة hex2bin() الخطأ E_WARNING في حال كان طول السلسلة النصية فرديًا (odd) أو ذات تمثيل ست عشري خطأ. | |||
=== سجل التغييرات === | |||
{| class="wikitable" | |||
|الإصدار | |||
|الوصف | |||
|- | |||
|5.5.1 | |||
|ترمي تحذيرًا إذا كان التمثيل الست عشري للسلسلة النصية المُدخلة غير صالح. | |||
|- | |||
|5.4.4 | |||
|ترمي تحذيرًا في حال ما كان طول السلسلة النصية فرديًا (odd). في النسخة 5.4.0 كانت الدالة hex2bin() تقبل السلسلة النصية بصمت مع اقتطاع البايت الأخير. | |||
|} | |||
=== أمثلة === | |||
==== المثال 1: مثال بسيط عن الدالة hex2bin() ==== | |||
<syntaxhighlight lang="php"> | |||
<?php | |||
$hex = hex2bin("6578616d706c65206865782064617461"); | |||
var_dump($hex); | |||
?> | |||
</syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="php"> | |||
string(16) "example hex data" | |||
</syntaxhighlight> | |||
=== انظر أيضًا === | |||
* bin2hex(): تَحوِيل البيانات ثنائية التمثيل إلى التمثيل الست عشري. | |||
* unpack(): تَفريغ البيانات من سلسلة نصية بالنظام الثنائي. | |||
=== مصادر === | |||
* صفحة الدالة hex2bin في توثيق PHP الرسمي. | |||
مراجعة 13:30، 5 أبريل 2018
((PHP 5 >= 5.4.0, PHP 7
تُفك الدالة hex2bin() الترميز الست عشري للسلاسل النصية ثنائية التمثيل.
الوصف
string hex2bin(string $data)
تُفك الدالة hex2bin() الترميز الست عشري للسلاسل النصية ثنائية التمثيل.
تنبيه: لا تُحوِل الدالة hex2bin() التمثيل الست عشري للأعداد إلى التمثيل الثنائي، بل تُستَعمل الدالة base_convert() لإجراء هكذا تحويل.
المعاملات
data
البيانات المُرَمَّزة بالتمثيل الست عشري.
القيم المعادة
تُعيد الدالة hex2bin() التمثيل الثنائي للبيانات المُدخَلة، أو القيمة FALSE في حالة الفشل.
الأخطاء والاستثناءات
ترمي الدالة hex2bin() الخطأ E_WARNING في حال كان طول السلسلة النصية فرديًا (odd) أو ذات تمثيل ست عشري خطأ.
سجل التغييرات
| الإصدار | الوصف |
| 5.5.1 | ترمي تحذيرًا إذا كان التمثيل الست عشري للسلسلة النصية المُدخلة غير صالح. |
| 5.4.4 | ترمي تحذيرًا في حال ما كان طول السلسلة النصية فرديًا (odd). في النسخة 5.4.0 كانت الدالة hex2bin() تقبل السلسلة النصية بصمت مع اقتطاع البايت الأخير. |
أمثلة
المثال 1: مثال بسيط عن الدالة hex2bin()
<?php
$hex = hex2bin("6578616d706c65206865782064617461");
var_dump($hex);
?>
يُعيد المثال السابق ما يلي:
string(16) "example hex data"
انظر أيضًا
- bin2hex(): تَحوِيل البيانات ثنائية التمثيل إلى التمثيل الست عشري.
- unpack(): تَفريغ البيانات من سلسلة نصية بالنظام الثنائي.
مصادر
- صفحة الدالة hex2bin في توثيق PHP الرسمي.