(PHP 4, PHP 5)
pack — Packt Daten in eine Binär-Zeichenkette
Packt die angegebenen Argumente unter Beachtung von
format in eine Binär-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.
Beachten sie auch, dass PHP Ganzzahlwerte intern als vorzeichenbehaftete Werte speichert, deren Größe vom Maschinentyp abhängig ist. Wenn Sie PHP einen vorzeichenlosen Ganzzahlwert geben, der für diese Art der Speicherung zu groß ist, wird er in eine Gleitkommazahl umgewandelt, was oft zu unerwünschten Ergebnissen führt.
format
Die Zeichenkette format besteht 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är-Zeichenkette gepackt werden sollen.
Zurzeit sind folgende Formate implementiert:
| 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) |
| f | Gleitkommazahl (maschinenabhängige Größe und Wiedergabe) |
| d | Double-Typ (maschinenabhängige Größe und Wiedergabe) |
| x | NUL Byte |
| X | geht in der Zeichenkette ein Byte rückwärts |
| @ | NUL-Auffüllung bis zur absoluten Position |
args
Gibt die Daten als Binär-Zeichenkette zurück.
Beispiel #1 pack()-Beispiel
<?php
$binaerdaten = pack("nvc*", 0x1234, 0x5678, 65, 66);
?>
Die sich daraus ergebende Binär-Zeichenkette ist sechs Bytes lang und enthält die Byte-Folge 0x12, 0x34, 0x78, 0x56, 0x41, 0x42.