array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.unpack.php', 1 => 'unpack', 2 => 'Entpackt die Daten einer binäre Zeichenkette', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Sonstige Funktionen', ), 'prev' => array ( 0 => 'function.uniqid.php', 1 => 'uniqid', ), 'next' => array ( 0 => 'function.usleep.php', 1 => 'usleep', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', '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 — Entpackt die Daten einer binäre Zeichenkette

Beschreibung

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

Überträgt die Daten einer binäre Zeichenkette in ein Array unter Berücksichtigung des Parameters format.

Die entpackten Daten werden in einem assoziativen Array abgebildet. Hierzu müssen die verschiedenen Format-Codes benannt und mit "/" getrennt werden. Wenn ein sich wiederholendes Argument existiert, werden die Array-Schlüssel durchnummeriert, indem ihnen eine Zahl angehängt wird.

Änderungen wurden durchgeführt, um diese Funktion in Übereinstimmung mit Perl zu bringen:

Parameter-Liste

format

Die Format-Codes werden unter pack() näher erläutert.

string

Die gepackten Daten.

offset

Der Offset, an dem das Entpacken beginnt.

Rückgabewerte

Gibt ein assoziatives Array zurück, das die entpackten Elemente als binäre Zeichenkette enthält. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
7.2.0 float- und double-Typen unterstützen sowohl Big-Endian als auch Little-Endian.
7.1.0 Der optionale offset wurde hinzugefügt.

Beispiele

Beispiel #1 unpack()-Beispiel

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Beispiel #2 unpack()-Beispiel mit Wiederholer

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Anmerkungen

Achtung

Beachten Sie, dass PHP Integer-Werte intern mit Vorzeichen speichert. Wenn Sie einen großen vorzeichenlosen Longwert entpacken und er von der selben Größe ist, die PHP für dessen Speicherung verwendet, wird das Ergebnis ein negativer Wert sein (auch wenn Sie dieses als vorzeichenlos zu entpacken angegeben haben).

Achtung

Wird ein Element nicht benannt, dann werden numerische Indizes beginnend mit 1 verwendet. Es ist zu berücksichtigen, dass im Falle mehrerer unbenannter Elemente ein Teil der Daten überschrieben wird, da die Nummerierung für jedes Element wieder bei 1 beginnt.

Beispiel #3 unpack()-Beispiel mit unbenannten Schlüsseln

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Es ist zu beachten, dass der erste Wert vom Symbol c mit dem Wert vom Symbol n überschrieben wurde.

Siehe auch