pack

(PHP 4, PHP 5, PHP 7, PHP 8)

packPackt Daten in eine binäre Zeichenkette

Beschreibung

pack(string $format, mixed ...$values): string

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 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ä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*"0x12340x56786566);
?>

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

Anmerkungen

Achtung

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.

Siehe auch

  • unpack() - Entpackt die Daten einer binäre Zeichenkette

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

PHPUnit in der Version 10 erschienen

Das beliebte Testframeworks PHPUnit ist in der Version 10 erschienen und steht zum Download bereit ...

TheMax

Autor : TheMax
Kategorie: Software & Web-Development

Laravel 10 veröffentlicht

Laravel Version 10 steht mit einer Mindestanforderung von PHP 8.1 zum Download bereit. ...

admin

Autor : admin
Kategorie: Software & Web-Development

DeepL Erweiterung Write als beta veröffentlicht

DeepL hat eine neuen Dienst Namens „write“ veröffentlicht, der die Rechtschreibung und Grammatik mit KI verbessern soll. ...

admin

Autor : admin
Kategorie: Dies und Das

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

Aufsatz

Hallo! Ich wollte meine Entdeckung mit euch teilen - Ghostwriter​ (https://wirschreiben.at/) . Diese Seite ist eine echte Oase für Schriftstell ...

Geschrieben von Faraon23 am 08.06.2023 21:04:40
Forum: Apps und PHP Script Gesuche
Aufsatz schreiben

Brauchen Sie Hilfe bei Ihrem Aufsatz? Ich kann Ihnen mit einer Empfehlung weiterhelfen und Sie über diesen Dienst informieren Ghostwriter Deutsch ...

Geschrieben von Faraon23 am 07.06.2023 18:56:39
Forum: Apps und PHP Script Gesuche
Welche Ghostwriter Agentur kontaktieren?

WirWRITE ist eine aussergewöhnliche Plattform, die Menschen in der Schweiz mit Erfahrene und seriöse Ghostwriter für alle Fachbereiche​ (http ...

Geschrieben von John534 am 07.06.2023 15:39:37
Forum: Off-Topic Diskussionen
Formular- Antwort

Das war es, ich musste der Datei einfach nur wieder :)den Originalnamen geben. Nun funktioniert es perfekt. Danke.

Geschrieben von Dirk66 am 21.05.2023 18:19:21
Forum: PHP Developer Forum