pack
(PHP 4, PHP 5, PHP 7, PHP 8)
pack — Packt Daten in eine binäre Zeichenkette
Beschreibung
Packt die angegebenen Argumente unter Beachtung von
format in eine binäre Zeichenkette.
Die Idee für diese Funktion entstammt Perl. Alle Formatierungs-Anweisungen funktionieren genau wie dort, allerdings fehlen in PHP einige Format-Codes von Perl (z. B. "u").
Beachten sie, dass der Unterschied zwischen vorzeichenlosen und vorzeichenbehafteten Werten nur Einfluss auf die Funktion unpack() hat, wogegen die Funktion pack() bei vorzeichenlosen und vorzeichenbehafteten Format-Codes dasselbe Ergebnis liefert.
Parameter-Liste
-
format -
Die Zeichenkette
formatbesteht aus Format-Codes, gefolgt von einem optionalen Wiederholungs-Argument. Dieses Argument kann ein ganzzahliger Wert sein oder ein*für Wiederholung bis ans Ende der Daten. Bei den Format-Codes a, A, h und H gibt das Wiederholungs-Argument an, wie viele gleiche Zeichen folgen. Im Zusammenhang mit "@" gibt das Wiederholungs-Argument die absolute Position an, ab der das nächste Zeichen steht. Bei allen anderen steht der Wiederholungs-Zähler für die Anzahl der benutzten Daten-Argumente, die in die sich ergebende binäre Zeichenkette gepackt werden sollen.Zurzeit sind folgende Formate implementiert:
pack()-Formatzeichen Code Beschreibung a mit NUL gefüllte Zeichenkette A mit Leerzeichen gefüllte Zeichenkette h Hex-Zeichenkette, unterer Halbwert zuerst H Hex-Zeichenkette, oberer Halbwert zuerst c vorzeichenbehaftetes Zeichen C vorzeichenloses Zeichen s vorzeichenbehafteter Short-Typ (immer 16 Bit, Byte-Folge maschinenabhängig) S vorzeichenloser Short-Typ (immer 16 Bit, Byte-Folge maschinenabhängig) n vorzeichenloser Short-Typ (immer 16 Bit, Byte-Folge Big-Endian) v vorzeichenloser Short-Typ (immer 16 Bit, Byte-Folge Little-Endian) i vorzeichenbehaftete Ganzzahl (Größe und Byte-Folge maschinenabhängig) I vorzeichenlose Ganzzahl (Größe und Byte-Folge maschinenabhängig) l vorzeichenbehafteter Long-Typ (immer 32 Bit, Byte-Folge maschinenabhängig) L vorzeichenloser Long-Typ (immer 32 Bit, Byte-Folge maschinenabhängig) N vorzeichenloser Long-Typ (immer 32 Bit, Byte-Folge Big-Endian) V vorzeichenloser Long-Typ (immer 32 Bit, Byte-Folge Little-Endian) q vorzeichenbehafteter Long-Long-Typ (immer 64 Bit, maschinenabhängig) Q vorzeichenloser Long-Long-Typ (immer 64 Bit, maschinenabhängig) J vorzeichenloser Long-Long-Typ (immer 64 Bit, Byte-Folge Big-Endian) P vorzeichenloser Long-Long-Typ (immer 64 Bit, Byte-Folge Little-Endian) f Gleitkommazahl (maschinenabhängige Größe und Wiedergabe) g Gleitkommazahl (maschinenabhängige Größe, Byte-Folge Little-Endian) G Gleitkommazahl (maschinenabhängige Größe, Byte-Folge Big-Endian) d Double-Typ (maschinenabhängige Größe und Wiedergabe) e Double-Typ (maschinenabhängige Größe, Byte-Folge Little-Endian) E Double-Typ (maschinenabhängige Größe, Byte-Folge Big-Endian) x NUL Byte X geht in der Zeichenkette ein Byte rückwärts Z NUL-aufgefüllte Zeichenkette @ NUL-Auffüllung bis zur absoluten Position -
values -
Rückgabewerte
Gibt die Daten als binäre Zeichenkette zurück. Bei einem Fehler wird false zurückgegeben.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
Diese Funktion gibt bei einem Fehler nicht mehr false zurück.
|
| 7.2.0 | float- und double-Typen unterstützen sowohl Big-Endian als auch Little-Endian. |
| 7.0.15, 7.1.1 | Die Codes "e", "E", "g" und "G" wurden hinzugefügt, um die Byte-Folgen-Unterstützung für float und double zu ermöglichen. |
Beispiele
Beispiel #1 pack()-Beispiel
<?php
$binaerdaten = pack("nvc*", 0x1234, 0x5678, 65, 66);
?>
Die sich daraus ergebende binäre Zeichenkette ist sechs Bytes lang und enthält die Byte-Folge 0x12, 0x34, 0x78, 0x56, 0x41, 0x42.
Anmerkungen
Es ist zu beachten, dass PHP int-Werte intern als
vorzeichenbehaftete Werte einer maschinenabhängigen Größe speichert (C-Typ
long). Integer-Literale und Operationen, die Zahlen
außerhalb der Grenzen des Typs int ergeben, werden als
float gespeichert. Wenn diese Floats als Integer gepackt
werden, werden sie zuerst in den Integer-Typ gewandelt. Dies kann u. U.
ein nicht erwünschtes Byte-Muster ergeben.
Der wichtigste Fall ist das Packen vorzeichenloser Zahlen, die als
int-Typ darstellbar wären, wenn dieser vorzeichenlos wäre.
Auf Systemen wo der Typ int 32 Bit groß ist, resultiert die
Umwandlung üblicherweise im selben Byte-Muster, wie wenn der
int vorzeichenlos wäre (allerdings ist das auf
implementierungsspezifische Konvertierungen von vorzeichenlosen in
vorzeichenbehaftete Zahlen gemäß dem C-Standard angewiesen). Auf Systemen,
wo der Typ int 64 Bit groß ist, hat float
vermutlich keine Mantisse, die groß genug ist, um den Wert ohne
Genauigkeitsverlust zu speichern. Haben diese Systeme ebenfalls einen
nativen 64bit-C-int-Typ (die meisten UNIX-artigen
Systeme haben das nicht), dann ist die einzige Möglichkeit, das Packformat
I im oberen Bereich zu nutzen, negative
int-Werte mit der gleichen Byte-Darstellung wie die
gewünschten vorzeichenlosen Werte zu erzeugen.
