PHP unpack()Функции

PHP Misc 参考手册Справочное руководство по PHP: разное

Примеры

Распаковка данных из бинарной строки:

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

Запустить пример »

Определение и использование

Функция unpack() распаковывает данные из бинарной строки.


Синтаксис

unpack(format,data)

Parameters Описание
format Обязательный. Указывает формат, используемый при распаковке данных.

Возможные значения:

  • a - строка, дополненная NUL
  • A - строка, дополненная пробелами
  • h - шестнадцатеричная строка, сначала младший полубайт
  • H - шестнадцатеричная строка, сначала старший полубайт
  • c - знаковый char
  • C - беззнаковый char
  • s - знаковый short (всегда 16-битный, машинный порядок байтов)
  • S - беззнаковый short (всегда 16-битный, машинный порядок байтов)
  • n - беззнаковый short (всегда 16-битный, порядок байтов big-endian)
  • v - беззнаковый short (всегда 16-битный, порядок байтов little-endian)
  • i - знаковое целое (зависит от размера машины и порядка байтов)
  • I - беззнаковое целое (зависит от размера машины и порядка байтов)
  • l - знаковый long (всегда 32-битный, машинный порядок байтов)
  • L - беззнаковый long (всегда 32-битный, машинный порядок байтов)
  • N - беззнаковый long (всегда 32-битный, порядок байтов big-endian)
  • V - беззнаковый long (всегда 32-битный, порядок байтов little-endian)
  • f - float (зависит от размера и представления на конкретной машине)
  • d - double (зависит от размера и представления на конкретной машине)
  • x - байт NUL
  • X - отступить на один байт
  • Z - строка с дополнением NUL
  • @ - заполнение NUL до абсолютной позиции
data Обязательно. Указывает двоичные данные для распаковки.

Технические детали

Возвращаемое значение: Возвращает массив в случае успеха или FALSE при ошибке.
Версия PHP: 4+
Список изменений: Начиная с PHP 5.5.0, для совместимости с Perl были внесены следующие изменения:

Код "a" сохраняет завершающие байты NULL.
Код "A" удаляет все завершающие пробельные символы ASCII.
Добавлен код "Z" для строк с дополнением NUL, который удаляет завершающие байты NULL.


Другие примеры

Пример 1

Распаковать данные:

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

Запустить пример »

Пример 2

Распаковать данные:

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

Запустить пример »


PHP Misc 参考手册Справочное руководство по разным разделам PHP Другие расширения