Função unpack() do PHP

Funções Diversas PHP

Definição e uso

A função unpack() desempacota dados de uma string binária.

Sintaxe

unpack(format,data)
Parâmetro Descrição
format Obrigatório. Define o formato usado para desempacotar os dados.
data Opcional. Define os dados binários desempacotados.

Valores possíveis do parâmetro format:

  • a - String preenchida com NULO
  • A - String preenchida com ESPAÇO
  • h - Stringa esadecimale, nibble mais baixo primeiro
  • H - Stringa esadecimale, nibble mais alto primeiro
  • c - signed char
  • C - unsigned char
  • s - signed short (sempre 16 bits, ordem de bytes da máquina)
  • S - unsigned short (sempre 16 bits, ordem de bytes da máquina)
  • n - unsigned short (sempre 16 bits, ordem de bytes big endian)
  • v - unsigned short (sempre 16 bits, ordem de bytes little endian)
  • i - signed integer (tamanho e ordem de bytes dependente da máquina)
  • I - unsigned integer (tamanho e ordem de bytes dependente da máquina)
  • l - signed long (sempre 32 bits, ordem de bytes da máquina)
  • L - unsigned long (sempre 32 bits, ordem de bytes da máquina)
  • N - unsigned long (sempre 32 bits, ordem de bytes big endian)
  • V - unsigned long (sempre 32 bits, ordem de bytes little endian)
  • f - float (tamanho e representação dependentes da máquina)
  • d - double (tamanho e representação dependentes da máquina)
  • x - Byte NUL
  • X - Voltar um byte
  • @ - Preencher com NUL até a posição absoluta

Exemplo

Exemplo 1

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

Saída:

Array
(
[1] => 80
[2] => 72
[3] => 80
)

Exemplo 2

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

Saída:

Array
(
[myint1] => 80
[myint2] => 72
[myint3] => 80
)

Exemplo 3

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

Saída:

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

Funções Diversas PHP