pack
(PHP 4, PHP 5, PHP 7)
pack — Packt Daten in eine Binär-Zeichenkette
Beschreibung
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.
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ä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) 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 (neu in PHP 5.5) @ NUL-Auffüllung bis zur absoluten Position -
... -
Changelog
| Version | Beschreibung |
|---|---|
| 7.2.0 | float und double Typen unterstützen sowohl Big Endian als auch Little Endian. |
| 7.0.15, 7.1.1 | Die "e", "E", "g" and "G" Codes wurden hinzugefügt, um Byte-Folgen-Unterstützung für float und double zu ermöglichen. |
| 5.6.3 | Die "q", "Q", "J" und "P" Codes wurden hinzugefügt, um die Arbeit mit 64-bit Zahlen zu ermöglichen. |
| 5.5.0 | Der "Z" Code mit equivalenter Funktionsweise wie "a" wurde zwecks Perl-Kompatibilität hinzugefügt. |
Beispiele
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.
Anmerkungen
Es ist zu beachten, dass PHP integer 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 integer-Typs 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 integer-Typ darstellbar wären, wenn dieser vorzeichenlos wäre. Auf Systemen wo der integer-Typ 32 bit groß ist, resultiert die Umwandlung üblicherweise im selben Byte-Muster wie wenn der integer vorzeichenlos wäre (allerdings ist das auf implementierungsspezifische Konvertierungen von vorzeichenlosen in vorzeichenbehaftete Zahlen gemäß dem C-Standard angewiesen). Auf Systemen wo der integer-Typ 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 64-bit C int-Typ (die meisten UNIX-artigen Systeme haben das nicht), dann ist die einzige Möglichkeit das I-Packformat auf den oberen Bereich zu nutzen, negative integer Werte mit der gleichen Byte-Darstellung wie die gewünschten vorzeichenlosen Werte zu erzeugen.
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-function.pack.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.
