PHPのunpack()関数の使い方を徹底解説！フォーマットコード一覧と実例付き

PHPのunpack()関数は、バイナリ文字列からデータを展開（アンパック）するための関数です。pack()関数でパックしたバイナリデータや、ファイルから読み込んだバイナリデータを解析する際によく使われます。

構文

unpack(format, data)

パラメータ

• format − データの展開に使用するフォーマットを指定します。指定可能な値は以下の通りです。

  • a − NUL埋めされた文字列

  • A − スペース（空白）埋めされた文字列

  • h − 16進数文字列（下位ニブルが先）

  • H − 16進数文字列（上位ニブルが先）

  • c − 符号付きchar（signed char）

  • C − 符号なしchar（unsigned char）

  • s − 符号付きshort（常に16ビット、マシンのバイト順）

  • S − 符号なしshort（常に16ビット、マシンのバイト順）

  • n − 符号なしshort（常に16ビット、ビッグエンディアン）

  • v − 符号なしshort（常に16ビット、リトルエンディアン）

  • i − 符号付き整数（サイズおよびバイト順はマシン依存）

  • I − 符号なし整数（サイズおよびバイト順はマシン依存）

  • l − 符号付きlong（常に32ビット、マシンのバイト順）

  • L − 符号なしlong（常に32ビット、マシンのバイト順）

  • N − 符号なしlong（常に32ビット、ビッグエンディアン）

  • V − 符号なしlong（常に32ビット、リトルエンディアン）

  • f − float（サイズおよび表現はマシン依存）

  • d − double（サイズおよび表現はマシン依存）

  • x − NULバイト（1バイト読み飛ばす）

  • X − 1バイト前に戻る

  • Z − NUL埋めされた文字列

  • @ − 指定した絶対位置までNULで埋める

• data − 展開対象となるバイナリデータを指定します。

戻り値

unpack()関数は、成功した場合には連想配列を返し、失敗した場合にはfalseを返します。

使用例

次の例では、文字列「Jacob」を1バイトずつ符号なしcharとして展開し、各文字のASCIIコード（数値）を取得しています。

<?php
   $var = "Jacob";
   print_r(unpack("C*myint", $var));
?>

実行結果

上記のコードを実行すると、以下の出力が得られます。

Array
(
   [myint1] => 74
   [myint2] => 97
   [myint3] => 99
   [myint4] => 111
   [myint5] => 98
)

このように、フォーマットコード「C*」を使うことで、文字列の各バイトが数値（ASCIIコード）として配列に格納されていることがわかります。「J」= 74、「a」= 97、「c」= 99、「o」= 111、「b」= 98 に対応しています。