PHP-Handbuch: Entpackt die Daten eines Binär-Strings

Beschreibung

array unpack ( string $format , string $data )

Überträgt die Daten eines Binär-Strings in ein Array unter Berücksichtigung des format-Parameters.

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.

Parameter-Liste

format: Die Format-Codes werden unter pack näher erläutert.
data: Die gepackten Daten.

Rückgabewerte

Gibt ein assoziatives Array zurück, dass die entpackten Elemente als Binärzeichenkette enthält.

Changelog

Version

Beschreibung

5.5.0

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

Der "a" Code erhält nun abschließende NULL Bytes.

Der "A" Code entfernt nun alle abschließenden ASCII Whitespaces (Leerzeichen, Tabs, Zeilenvorschübe, Wagenrückläufe und NULL Bytes).

Der "Z" Code wurde für mit NULL aufgefüllte Zeichenketten hinzugefügt, und entfernt abschließende NULL Bytes.

Beispiele

Beispiel #1 unpack Beispiel


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

Das Ergebnis Array enthält die Einträge "chars" mit dem wert 4 und "int" mit 160.

Beispiel #2 unpack Beispiel mit Wiederholer


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

Das Ergebnis Array wird die Einträge "chars1", "chars2" and "int" enthalten.

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

Beachten Sie, dass für nicht benannte Elemente ein leerer String verwendet wird. Werden mehrere Elemente nicht bennant, werden die entsprechenden Elemente überschrieben, da die verwendeten Schlüssel identisch sind:

Beispiel #3 unpack Beispiel mit unbenannten Schlüsseln


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

Das Ergebnis Array wird die Elemente "1" mit dem Wert 160 und "2" mit 66 enthalten. Der erste Wert vom Symbol c wurde mit dem Wert vom Symbol n überschrieben.

Siehe auch

pack