Sonstige Funktionen
PHP Manual

pack

(PHP 4, PHP 5)

packPackt Daten in eine Binär-Zeichenkette

Beschreibung

string pack ( string $format [, mixed $args [, mixed $... ]] )

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.

Parameter-Liste

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:

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)
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

Rückgabewerte

Gibt die Daten als Binär-Zeichenkette zurück.

Beispiele

Beispiel #1 pack()-Beispiel

<?php
$binaerdaten 
pack("nvc*"0x12340x56786566);
?>

Die sich daraus ergebende Binär-Zeichenkette ist sechs Bytes lang und enthält die Byte-Folge 0x12, 0x34, 0x78, 0x56, 0x41, 0x42.

Siehe auch


Sonstige Funktionen
PHP Manual