【PHP8.x】hexdec関数の使い方

Copy
1<?php
2
3/**
4 * 16進数文字列を10進数に変換するhexdec関数の使用例。
5 *
6 * この関数は、システムエンジニアを目指す初心者がhexdec関数の基本的な動作と、
7 * 戻り値の型（intまたはfloat）がどのように変化するかを理解するのに役立ちます。
8 */
9function demonstrateHexdecConversion(): void
10{
11    echo "--- hexdec関数の使用例 ---\n\n";
12
13    // 1. 基本的な16進数文字列 (A -> 10)
14    $hexString1 = 'A';
15    $decimal1 = hexdec($hexString1);
16    echo "1. 16進数 '{$hexString1}' は10進数で {$decimal1} です。型: " . gettype($decimal1) . "\n";
17
18    // 2. 複数の桁を持つ16進数文字列 (FF -> 255)
19    $hexString2 = 'FF';
20    $decimal2 = hexdec($hexString2);
21    echo "2. 16進数 '{$hexString2}' は10進数で {$decimal2} です。型: " . gettype($decimal2) . "\n";
22
23    // 3. 大文字と小文字は区別されないことを示す (abc -> 2748)
24    $hexString3 = 'abc';
25    $decimal3 = hexdec($hexString3);
26    echo "3. 16進数 '{$hexString3}' (小文字) は10進数で {$decimal3} です。型: " . gettype($decimal3) . "\n";
27
28    // 4. PHP_INT_MAX (システムが扱える最大の整数値) を超える場合の例
29    // この値はシステム（32ビットか64ビットか）に依存します。
30    // 一般的に、64ビット環境では '7FFFFFFFFFFFFFFF' (約9.22E18) はintで収まりますが、
31    // 'FFFFFFFFFFFFFFFF' (約1.84E19) はintの範囲を超えるためfloatになります。
32    $hexString4 = 'FFFFFFFFFFFFFFFF'; // 64ビットの最大符号なし整数を表す16進数
33    $decimal4 = hexdec($hexString4);
34    echo "4. 16進数 '{$hexString4}' は10進数で {$decimal4} です。型: " . gettype($decimal4) . "\n";
35    echo "   (PHP_INT_MAXを超える場合、hexdec関数は戻り値をfloat型で返します。)\n";
36
37    echo "\n--- 変換完了 ---\n";
38}
39
40// 関数を実行して、結果を表示します。
41demonstrateHexdecConversion();

PHPのhexdec関数は、16進数形式の文字列を10進数の数値に変換するために使用される便利な関数です。引数$hex_stringには、変換したい16進数の文字列を指定します。例えば、'A'（10）や'FF'（255）のような値を渡すことができます。この関数は、16進数の大文字と小文字を区別せず、'A'も'a'も同じ値として扱います。

戻り値は通常、整数型を示すintですが、PHPがシステム上で扱える最大の整数値（PHP_INT_MAX）を超えるような非常に大きな16進数を変換しようとした場合、結果は浮動小数点数型を示すfloatとして返されます。これは、正確な数値を失わずに大きな値を表現するためです。

サンプルコードでは、まず基本的な16進数文字列を10進数に変換する例を示し、次に複数桁の16進数や小文字の16進数も正しく変換されることを確認しています。特に、'FFFFFFFFFFFFFFFF'のように極めて大きな16進数を変換する例を通じて、PHP_INT_MAXを超える場合に、戻り値の型がfloatに変わる挙動を具体的に示しています。これにより、hexdec関数の基本的な使い方から、戻り値の型が変化する条件までを理解できます。