PHP unpack() 関数

バイナリ文字列からデータをアンパックします。

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

定義と使用法

unpack() 関数は、バイナリ文字列からデータをアンパックします。

構文

unpack(format,data)

パラメータ値

パラメータ

説明

フォーマット必要。データをアンパックするときに使用する形式を指定します。
可能な値:

a - NUL で埋められた文字列

A - スペースで埋められた文字列

h - 16 進文字列、下位ニブルが最初

H - 16 進文字列、上位ニブルが最初

c - 署名された文字

C - 符号なし文字

s - signed short (常に 16 ビット、マシンバイトオーダー)

S - unsigned short (常に 16 ビット、マシンバイトオーダー)

n - unsigned short (常に 16 ビット、ビッグエンディアンのバイト順)

v - unsigned short (常に 16 ビット、リトルエンディアンのバイト順)

i - 符号付き整数 (マシンに依存するサイズとバイト順)

I - 符号なし整数 (マシンに依存するサイズとバイト順)

l - signed long (常に 32 ビット、マシンバイトオーダー)

L - unsigned long (常に 32 ビット、マシンバイトオーダー)

N - unsigned long (常に 32 ビット、ビッグエンディアンのバイト順)

V - unsigned long (常に 32 ビット、リトルエンディアンのバイト順)

q - signed long long (常に 64 ビット、マシンバイトオーダー)

Q - unsigned long long (常に 64 ビット、マシンバイトオーダー)

J - unsigned long long (常に 64 ビット、ビッグエンディアンのバイト順)

P - unsigned long long (常に 64 ビット、リトルエンディアンのバイト順)

f - float (マシンに依存するサイズと表現)

g - float (マシンに依存するサイズ、リトルエンディアンのバイト順)

G - float (マシンに依存するサイズ、ビッグエンディアンのバイト順)

d - double (マシンに依存するサイズと表現)

e - double (マシンに依存するサイズ、リトルエンディアンのバイト順)

E - double (マシンに依存するサイズ、ビッグエンディアンのバイト順)

x - NUL バイト

X - 1 バイトのバックアップ

Z - NUL で埋められた文字列

@ - 絶対値への NUL フィル

データ必要。アンパックするバイナリデータを指定します。

オフセットオプション。アンパックを開始する場所を指定します。デフォルトは 0 です。

技術的な詳細

戻り値:
成功した場合は配列を返し、失敗した場合は FALSE を返します。

PHP バージョン:
4+

変更ログ:
PHP 7.2 - float と double は、ビッグエンディアンとスモールエンディアンの両方をサポートするようになりました。

PHP
7.1 - オプションのオフセットパラメータを追加しました。

PHP 5.5.0 - Perl との互換性のために次の変更が行われました。
「a」コードは、末尾の NULL バイトを保持するようになりました。

「A」コードは、末尾のすべての ASCII 空白を取り除くようになりました。

NULL で埋められた文字列に「Z」コードが追加され、末尾の NULL バイトが削除されます。