【PHP8.x】octdec()関数の使い方

Copy
1<?php
2
3/**
4 * PHPのoctdec関数を使用して、8進数文字列を10進数に変換する方法を示すサンプルコードです。
5 * システムエンジニアを目指す初心者が、数値変換の基本を理解するのに役立ちます。
6 */
7function convertOctalToDecimal(): void
8{
9    // 例1: 8進数文字列 '12' を10進数に変換します。
10    // 計算式: (1 * 8^1) + (2 * 8^0) = 8 + 2 = 10
11    $octalString1 = '12';
12    $decimalValue1 = octdec($octalString1);
13    echo "8進数 '$octalString1' は10進数で: $decimalValue1\n"; // 出力例: 8進数 '12' は10進数で: 10
14
15    // 例2: 別の8進数文字列 '77' を10進数に変換します。
16    // 計算式: (7 * 8^1) + (7 * 8^0) = 56 + 7 = 63
17    $octalString2 = '77';
18    $decimalValue2 = octdec($octalString2);
19    echo "8進数 '$octalString2' は10進数で: $decimalValue2\n"; // 出力例: 8進数 '77' は10進数で: 63
20
21    // 例3: 比較的大きな8進数文字列 '100' を10進数に変換します。
22    // 計算式: (1 * 8^2) + (0 * 8^1) + (0 * 8^0) = 64 + 0 + 0 = 64
23    $octalString3 = '100';
24    $decimalValue3 = octdec($octalString3);
25    echo "8進数 '$octalString3' は10進数で: $decimalValue3\n"; // 出力例: 8進数 '100' は10進数で: 64
26}
27
28// 関数を実行し、結果を表示します。
29convertOctalToDecimal();
30

PHPのoctdec関数は、8進数（オクタル）の文字列を10進数（デシマル）に変換するための標準関数です。この関数は、ファイルパーミッションの設定など、システム開発において8進数表記が用いられる場面で、数値を一般的な10進数に変換し、人間が理解しやすい形式で扱う際に役立ちます。

関数の引数には、変換したい8進数を表す文字列（string $octal_string）を渡します。例えば、'12'や'77'といった形式の文字列です。そして、戻り値としては、変換された10進数の整数値（int）が返されます。ただし、変換結果が非常に大きな数値になる場合には、浮動小数点数（float）として返されることもあります。

提供されたサンプルコードでは、このoctdec関数の使い方を具体的に示しています。例えば、8進数文字列'12'は10進数の10に、'77'は63に、'100'は64にそれぞれ変換される様子が示されています。これにより、8進数の各桁が8のN乗で重み付けされて計算される数値変換の仕組みを視覚的に理解することができます。システムエンジニアを目指す初心者の方にとって、このような異なる基数間の数値変換の基礎を学ぶことは、プログラミングやシステム管理の知識を深める上で非常に重要です。

Copy
1<?php
2
3/**
4 * octdec関数の基本的な使用例を示します。
5 * この関数は、八進数形式の文字列を対応する十進数の整数または浮動小数点数に変換します。
6 *
7 * octdec関数は数値の基数変換に特化しており、
8 * MIMEタイプ「application/octet-stream」（任意のバイナリデータ）における
9 * 「octet」（8ビットバイト）とは直接的な意味で関連しません。
10 * octdecは「八進数」という数値表現を扱い、octet-streamはデータ形式を指します。
11 */
12function demonstrateOctdecConversion(): void
13{
14    echo "--- PHP octdec 関数: 八進数文字列を十進数に変換する例 ---\n\n";
15
16    // 例1: 基本的な八進数文字列 "777" (十進数で 511)
17    $octalString1 = "777";
18    $decimalValue1 = octdec($octalString1);
19    echo "八進数 '{$octalString1}' は十進数で '{$decimalValue1}' です。\n";
20
21    // 例2: 0 で始まる八進数文字列 "010" (十進数で 8)
22    // octdecは文字列の先頭の0を八進数プレフィックスとして解釈しますが、必須ではありません。
23    $octalString2 = "010";
24    $decimalValue2 = octdec($octalString2);
25    echo "八進数 '{$octalString2}' は十進数で '{$decimalValue2}' です。\n";
26
27    // 例3: より大きな八進数文字列 (システムの int 型の最大値を超える可能性がある場合、float で返されます)
28    // PHPは必要に応じて自動的に int から float へ変換します。
29    $octalString3 = "2000000000000000000000"; // 非常に大きな八進数
30    $decimalValue3 = octdec($octalString3);
31    echo "八進数 '{$octalString3}' は十進数で '{$decimalValue3}' です。\n";
32    echo "  (この値の型は " . gettype($decimalValue3) . " です)\n";
33
34
35    // 例4: 八進数 "0" (十進数で 0)
36    $octalString4 = "0";
37    $decimalValue4 = octdec($octalString4);
38    echo "八進数 '{$octalString4}' は十進数で '{$decimalValue4}' です。\n";
39
40    // 例5: 無効な文字が含まれる場合
41    // octdecは、有効な八進数文字（0-7）ではない文字に遭遇すると、
42    // その直前の有効な八進数部分のみを変換します。
43    $octalString5 = "123abc"; // "abc" は無効な八進数文字
44    $decimalValue5 = octdec($octalString5);
45    echo "八進数 '{$octalString5}' (無効な文字含む) は十進数で '{$decimalValue5}' です。\n"; // "123" (八進数) -> 83 (十進数)
46
47    echo "\n--- 変換完了 ---";
48}
49
50// 関数を実行して、八進数から十進数への変換デモを開始します。
51demonstrateOctdecConversion();
52

PHPのoctdec関数は、八進数（基数8）形式の文字列を、対応する十進数（基数10）の数値に変換するために使用される関数です。この関数は、引数として変換したい八進数を表す文字列（string $octal_string）を受け取ります。戻り値は、変換された十進数の整数（int）となりますが、数値が非常に大きい場合は、浮動小数点数（float）として返されることがあります。

例えば、八進数文字列「777」は十進数の「511」に、八進数文字列「010」は十進数の「8」に変換されます。文字列に「0」が先行していても変換結果に影響はありません。また、指定された文字列に八進数として無効な文字（例: 8, 9, aなど）が含まれている場合、octdec関数は無効な文字の手前までの有効な八進数部分のみを変換します。

なお、このoctdec関数が扱う「八進数」は、MIMEタイプ「application/octet-stream」における「octet」（8ビットバイト）とは直接的な意味で関連しません。octdecは数値表現の基数変換を行う関数であり、「octet-stream」が示す任意のバイナリデータ形式とは異なる概念であるため、混同しないようご注意ください。