الدالة hex2bin()‎ في PHP

من موسوعة حسوب
< PHP
اذهب إلى التنقل اذهب إلى البحث

(‎(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()‎: تَفريغ البيانات من سلسلة نصية بالنظام الثنائي.

مصادر