(PHP 4, PHP 5)
unpack — Распаковывает данные из бинарной строки
$format
, string $data
)
Распаковывает данные из бинарной строки в массив согласно заданному в
format формату.
Распакованные данные хранятся в ассоциативном массиве. Для осуществления этого необходимо обозначить различные коды форматов и разделить их с помощью слэш /. Можно также передать замещающий аргумент, с помощью которого каждый ключ массива будет иметь порядковый номер после обозначенного имени ключа.
formatСм. функцию pack() для разъяснения кодов форматов.
dataУпакованные данные.
Возвращает ассоциативный массив, содержащий распакованные элементы бинарной строки.
Пример #1 Пример использования unpack()
<?php
$binarydata = "\x04\x00\xa0\x00";
$array = unpack("cchars/nint", $binarydata);
?>
Результирующий массив будет содержать записи "chars" со значением 4 и "int" с 160.
Пример #2 Пример использования unpack() с замещающим аргументом
<?php
$binarydata = "\x04\x00\xa0\x00";
$array = unpack("c2chars/nint", $binarydata);
?>
Результирующий массив будет содержать записи "chars1", "chars2" и "int".
Необходимо отметить, что PHP хранит значения как signed. Если распаковать large unsigned long и оно будет иметь тот же размер, что и хранимое PHP значение, то результатом будет отрицательное число, даже если было указано распаковывать как unsigned.
Если не обозначить элемент, то используется пустая строка. Если не обозначить более чем один элемент, то это значит, что некоторые данные будут перезаписаны, как например в:
Пример #3 Пример использования unpack() с безымянными ключами
<?php
$binarydata = "\x32\x42\x00\xa0";
$array = unpack("c2/n", $binarydata);
var_dump($array);
?>
Результирующий массив будет содержать записи "1" со значением 160 и "2" с 66. Первое значение из спецификатора c будет перезаписано первым значением из спецификатора n.