中文(繁體)
中文(繁體)
在處理十六進製字符串時，PHP 提供了一個內置函數hexdec() ，它可以將十六進制數轉換為十進制。然而，很多開發者在使用hexdec()時，會下意識地輸入帶有"0x" 前綴的字符串（如"0xFF" ），結果卻發現返回的數值並不是預期中的255，而是0。這種情況往往會讓人感到困惑：明明是合法的十六進制數，為什麼結果錯了？
本文將深入剖析這個現象，並提供正確的使用方式。
PHP 的hexdec()函數設計上是用來處理“純十六進製字符串”的，也就是說，它只接受0–9 和a–f（不區分大小寫）這類字符作為輸入。如果傳入的字符串中含有不屬於十六進製字符集的內容，PHP 會從字符串的開頭讀取，直到遇到第一個非法字符為止，然後截斷並轉換前面合法的部分。
<?php
echo hexdec("FF"); // 輸出: 255
?>
這是一個典型的、符合預期的例子。
現在來看問題的根源：
<?php
echo hexdec("0xFF"); // 輸出: 0
?>
此時輸出的不是255，而是0。原因很簡單： hexdec()會在遇到第一個非法字符時停止解析，而字符串"0xFF"的第一個字符是0 ，合法；第二個字符是x ，這是非法的十六進製字符。因此PHP 只解析了第一個字符0 ，於是返回了0。
在許多編程語言（如C/C++、JavaScript、Python）中，帶有"0x"前綴的寫法是合法的十六進制格式。因此，一些開發者會自然地將"0xFF"當作合法輸入傳給PHP 的hexdec() ，而沒意識到PHP 並不認這個前綴。
一種通用且簡單的解決方式是，使用ltrim()處理字符串，去掉可能存在的"0x"或"0X"前綴：
<?php
$input = "0xFF";
$clean = ltrim($input, "0xX"); // 會去除所有 "0", "x", "X" 開頭字符（不精確）
echo hexdec($clean); // 輸出: 255
?>
但這種寫法也有陷阱，因為ltrim("0x0F", "0xX")會得到"F" ，這可能不是我們想要的。更安全的方法是使用preg_replace()精確地移除前綴：
<?php
$input = "0xFF";
$clean = preg_replace('/^0x/i', '', $input);
echo hexdec($clean); // 輸出: 255
?>
這樣只會移除開頭的"0x"或"0X" ，而不會破壞數字本身。
如果你在處理URL 中的參數時遇到十六進製字符串，尤其是來自像https://gitbox.net/api?color=0xFF00FF這樣的地址，應特別注意：
<?php
$hex = $_GET['color']; // 例如: 0xFF00FF
$hex = preg_replace('/^0x/i', '', $hex);
$decimal = hexdec($hex);
echo $decimal; // 輸出: 16711935
?>
這確保你能夠正確解析帶有"0x"前綴的十六進制數。
PHP 的hexdec()並不識別"0x"前綴，它僅將字符串視為純十六進製字符的集合。因此在使用hexdec()前，開發者需要手動清理字符串，去除"0x"前綴，以避免得到錯誤的數值。了解並處理這一細節，是保障PHP 程序準確性的關鍵。
