PHP unpack()関数

定義と使用法

unpack()関数はバイナリ文字列からデータをデコードします。

文法

unpack(format,data)
パラメータ 説明
format 必須。デコードデータに使用される形式を指定します。
data オプション。デコードされるバイナリデータを指定します。

format パラメータの可能な値:

  • a - NULでパディングされた文字列
  • A - SPACEでパディングされた文字列
  • h - Hex string,ロウニブブルが最初
  • H - Hex string,ハイニブブルが最初
  • c - signed char
  • C - unsigned char
  • s - signed short(常に16ビット、マシンのバイトオーダー)
  • S - unsigned short(常に16ビット、マシンのバイトオーダー)
  • n - unsigned short(常に16ビット、ビッグエンディアンバイトオーダー)
  • v - unsigned short(常に16ビット、リトルエンディアンバイトオーダー)
  • i - signed integer(マシン依存のサイズとバイトオーダー)
  • I - unsigned integer(マシン依存のサイズとバイトオーダー)
  • l - signed long(常に32ビット、マシンのバイトオーダー)
  • L - unsigned long(常に32ビット、マシンのバイトオーダー)
  • N - アンサインドロング (常に 32ビット、ビッグエンディアン バイトオーダー)
  • V - アンサインドロング (常に 32ビット、リトルエンディアン バイトオーダー)
  • f - フロート (マシン依存のサイズと表現)
  • d - ドブル (マシン依存のサイズと表現)
  • x - NUL バイト
  • X - 1バイト前のバックアップ
  • @ - 絶対位置への NUL フィル

例 1

<?php
$data = "PHP";
print_r(unpack("C*",$data));
?>

出力:

配列
(
[1] => 80
[2] => 72
[3] => 80
)

例 2

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

出力:

配列
(
[myint1] => 80
[myint2] => 72
[myint3] => 80
)

例 3

<?php
$bin = pack("c2n2",0x1234,0x5678,65,66);
print_r(unpack("c2chars/n2int",$bin));
?>

出力:

配列
(
[chars1] => 52
[chars2] => 120
[int1] => 65
[int2] => 66
)