array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.unpack.php', 1 => 'unpack', 2 => 'Распаковывает данные из бинарной строки', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Разные функции', ), 'prev' => array ( 0 => 'function.uniqid.php', 1 => 'uniqid', ), 'next' => array ( 0 => 'function.usleep.php', 1 => 'usleep', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/misc/functions/unpack.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

unpack

(PHP 4, PHP 5, PHP 7, PHP 8)

unpack — Распаковывает данные из бинарной строки

Описание

unpack(string $format, string $string, int $offset = 0): array|false

Функция распаковывает данные из бинарной строки с учётом формата, который задали в параметре format.

Функция сохранит данные, которые распаковала, в ассоциативном массиве, если отдельным кодам форматов назначили имена и разделили слешем /. Функция добавит порядковый номер после имени ключа каждого элемента массива, если указали аргумент повторителя.

Следующие изменения внесли, чтобы функция соответствовала языку Perl:

Список параметров

format

Коды форматов объясняет описание функции pack().

string

Упакованные данные.

offset

Смещение, с которого требуется начать распаковку.

Возвращаемые значения

Функция возвращает ассоциативный массив, который содержит распакованные элементы двоичной строки, или false, если возникла ошибка.

Список изменений

Версия Описание
7.2.0 Типы float и double поддерживают как прямой, так и обратный порядок байтов.
7.1.0 Добавили необязательный параметр offset.

Примеры

Пример #1 Пример распаковки данных из двоичной строки функцией unpack()

<?php

$binarydata = "\x04\x00\xa0\x00";
$array = unpack("cchars/nint", $binarydata);
print_r($array);

?>

Результат выполнения приведённого примера: 

Array
(
    [chars] => 4
    [int] => 160
)

Пример #2 Пример работы функции unpack() с повторителем

<?php

$binarydata = "\x04\x00\xa0\x00";
$array = unpack("c2chars/nint", $binarydata);
print_r($array);

?>

Результат выполнения приведённого примера: 

Array
(
    [chars1] => 4
    [chars2] => 0
    [int] => 40960
)

Примечания

Предостережение

Обратите внимание, что PHP внутренне хранит целые значения как знаковые. Результатом будет отрицательное число, даже если указали беззнаковую распаковку, если распаковать большое значение с типом unsigned long с таким же размером, как у значения, которое PHP хранит внутри.

Предостережение

функция присвоит числовые индексы начиная с 1, если не назвать элемент. Функция перезапишет часть данных, поскольку нумерация каждого элемента перезапускается с 1 для каждого такого элемента, если будет больше одного безымянного элемента.

Пример #3 Пример работы функции unpack() с безымянными ключами

<?php

$binarydata = "\x32\x42\x00\xa0";
$array = unpack("c2/n", $binarydata);
var_dump($array);

?>

Результат выполнения приведённого примера: 

array(2) {
  [1]=>
  int(160)
  [2]=>
  int(66)
}

Обратите внимание, что первое значение спецификатора c перезаписывается первым значением спецификатора n.

Смотрите также