الفرق بين المراجعتين لصفحة: «PHP/hex2bin»
< PHP
هارون-بوكرش (نقاش | مساهمات) لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
((PHP 5 >= 5.4.0, PHP 7 | ((PHP 5 >= 5.4.0, PHP 7 | ||
تُفك الدالة | تُفك الدالة <code>hex2bin()</code> الترميز الست عشري للسلاسل النصية ثنائية التمثيل. | ||
== الوصف == | |||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
string hex2bin(string $data) | string hex2bin(string $data) | ||
</syntaxhighlight>تُفك الدالة | </syntaxhighlight>تُفك الدالة <code>hex2bin()</code> الترميز الست عشري للسلاسل النصية ثنائية التمثيل. | ||
تنبيه: لا تُحوِل الدالة <code>hex2bin()</code> التمثيل الست عشري للأعداد إلى التمثيل الثنائي، بل تُستَعمل الدالة <code>[[PHP/base convert|base_convert()]]</code> لإجراء هكذا تحويل. | |||
== المعاملات == | |||
=== | === <code>data</code> === | ||
البيانات المُرَمَّزة بالتمثيل الست عشري. | البيانات المُرَمَّزة بالتمثيل الست عشري. | ||
== القيم المعادة == | |||
تُعيد الدالة hex2bin() التمثيل الثنائي للبيانات المُدخَلة، أو القيمة FALSE في حالة الفشل. | تُعيد الدالة <code>hex2bin()</code> التمثيل الثنائي للبيانات المُدخَلة، أو القيمة FALSE في حالة الفشل. | ||
== الأخطاء والاستثناءات == | |||
ترمي الدالة hex2bin() الخطأ E_WARNING في حال كان طول السلسلة النصية فرديًا (odd) أو ذات تمثيل ست عشري خطأ. | ترمي الدالة <code>hex2bin()</code> الخطأ E_WARNING في حال كان طول السلسلة النصية فرديًا (odd) أو ذات تمثيل ست عشري خطأ. | ||
== سجل التغييرات == | |||
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | |||
!الوصف | |||
|- | |- | ||
|5.5.1 | |5.5.1 | ||
| سطر 31: | سطر 31: | ||
|- | |- | ||
|5.4.4 | |5.4.4 | ||
|ترمي تحذيرًا في حال ما كان طول السلسلة النصية فرديًا (odd). في النسخة 5.4.0 كانت الدالة hex2bin() تقبل السلسلة النصية بصمت مع اقتطاع البايت الأخير. | |ترمي تحذيرًا في حال ما كان طول السلسلة النصية فرديًا (odd). في النسخة 5.4.0 كانت الدالة <code>hex2bin()</code> تقبل السلسلة النصية بصمت مع اقتطاع البايت الأخير. | ||
|} | |} | ||
== أمثلة == | |||
المثال 1: مثال بسيط عن الدالة <code>hex2bin()</code><syntaxhighlight lang="php"> | |||
<?php | |||
<syntaxhighlight lang="php"> | |||
$hex = hex2bin("6578616d706c65206865782064617461"); | $hex = hex2bin("6578616d706c65206865782064617461"); | ||
var_dump($hex); | var_dump($hex); | ||
?> | ?> | ||
</syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang="text"> | |||
</syntaxhighlight>يُعيد المثال السابق ما يلي:<syntaxhighlight lang=" | |||
string(16) "example hex data" | string(16) "example hex data" | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | |||
* bin2hex(): تَحوِيل البيانات ثنائية التمثيل إلى التمثيل الست عشري. | * <code>[[PHP/bin2hex|bin2hex()]]</code>: تَحوِيل البيانات ثنائية التمثيل إلى التمثيل الست عشري. | ||
* unpack(): تَفريغ البيانات من سلسلة نصية بالنظام الثنائي. | * <code>[[PHP/unpack|unpack()]]</code>: تَفريغ البيانات من سلسلة نصية بالنظام الثنائي. | ||
== مصادر == | |||
* صفحة الدالة hex2bin في توثيق PHP الرسمي. | * [http://php.net/manual/en/function.hex2bin.php صفحة الدالة hex2bin في توثيق PHP الرسمي]. | ||
مراجعة 16:57، 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(): تَفريغ البيانات من سلسلة نصية بالنظام الثنائي.