sprintf
Gibt einen formatierten String zurück
&reftitle.description;
stringsprintf
stringformat
mixedargs
mixed...
Gibt eine an Hand des Formatierungs-Strings format
gebildete Zeichenkette zurück.
&reftitle.parameters;
format
Der Formatierungs-String wird aus null oder mehreren Anweisungen
gebildet: Gewöhnliche Zeichen (außer %), die direkt in
das Ergebnis übertragen werden, und
Umsetzungs-Anweisungen. Jede dieser Anweisungen holt
sich als Resultat ihre eigenen Parameter. Diese Anweisungen gelten sowohl
für die sprintf- als auch für die
printf-Funktion.
Jede der Formatierugs-Anweisungen besteht aus einem
Prozent-Zeichen (%), gefolgt von einem oder mehrereren
der folgenden Elemente:
Eine optionale Vorzeichenangabe, die die
Verwendung eines Vorzeichens (- oder +) vor einer Zahl erzwingt.
Standardmäßig wird nur das - Zeichen vor negativen Zahlen verwendet.
Die Vorzeichenangabe erzwingt, dass positive Zahlen ein + Zeichen
vorangestellt bekommen, und wurde mit PHP 4.3.0 eingeführt.
Ein optionales Füllzeichen, das festlegt, mit
welchem Zeichen ein String bis zum Erreichen einer bestimmten Länge
aufgefüllt wird. Dies kann ein Leerzeichen oder eine
0 (das Null-Zeichen) sein. Standardmäßig wird
mit dem Leerzeichen gefüllt. Andere Füllzeichen können durch
Voranstellen eines einfachen Anführungszeichens (')
definiert werden. Beachten Sie die nachstehenden Beispiele.
Eine optionale Angabe der Ausrichtung, die
bestimmt, ob das Ergebnis rechts- oder linksbündig ausgerichtet werden
soll. Das Standardverhalten ist rechtsbündige Ausrichtung, ein
--Zeichen an dieser Stelle lässt den Text
linksbündig erscheinen.
Eine optionale Zahl für die Längenangabe,
welche die mindestens zurückzugebende Anzahl Zeichen spezifiziert.
Ein optionaler Wert für die Anzahl der auszugebenden
Dezimalstellen für Fließkommazahlen. Wenn diese
Anweisung auf einen String angewendet wird, gibt sie die Länge an,
die der resultierende String maximal erreichen kann. Darüber
hinausgehendes wird abgeschnitten.
Eine Typangabe, welche den Typ enthält,
als der das jeweils übergebene Argument angesehen werden soll.
Mögliche Angaben sind:
% - ein Prozentzeichen. Es ist kein
Argument erforderlich.
b - das Argument wird als Integer
angesehen und als Binär-Wert ausgegeben.
c - das Argument wird als Integer
angesehen, und das entsprechende ASCII-Zeichen wird
ausgegeben.
d - das Argument wird als Integer
angesehen und als vorzeichenbehafteter Dezimalwert
(signed integer) ausgegeben.
e - das Argument wird als wissenschaftliche
Notation betrachtet (z.B. 1.2e+2). Die Genauigkeitsangabe steht
seit PHP 5.2.1 für die Anzahl der Dezimalstellen. In früheren
PHP-Versionen wurde sie als signifikante Stelle betrachtet (eine
Stelle weniger).
u - das Argument wird als Integer
angesehen und ein positiver vorzeichenloser Dezimalwert (unsigned
integer) ausgegeben.
f - das Argument wird als float angesehen und
entsprechend der Einstellungen in den locales als Fließkommazahl
ausgegeben.
F - das Argument wird als float angesehen und
unabhängig von den Einstellungen in den locales als Fließkommazahl
ausgegeben.
Verfügbar ab PHP 4.3.10 und PHP 5.0.3.
o - das Argument wird als Integer
angesehen und als Oktalzahl ausgegeben.
s - das Argument wird als String angesehen
und auch als solcher ausgegeben.
x - das Argument wird als Integer
angesehen und als Hexadezimalwert ausgegeben (mit
Kleinbuchstaben).
X - das Argument wird als Integer
angesehen und als Hexadezimalwert ausgegeben (mit
Großbuchstaben).
Der Formatstring unterstützt nummerierte Argumente und kann daher auch
ihre Position bestimmen (argument numbering/swapping). Hier ein Beispiel:
Argumente tauschen
]]>
Dies könnte "There are 5 monkeys in the tree" ausgeben. Aber nehmen
wir einmal an, dass wir den Formatstring in einer separaten Datei
erstellen, da wir ihn internationalisieren wollen und deshalb wie
folgt umschreiben:
Argumente tauschen
]]>
Nun haben wir ein Problem. Die Reihenfolge der Platzhalter im
Formatstrings entspricht nicht mehr der Reihenfolge der Argumente im
Code. Wir würden gern den Code belassen wie er ist und einfach im
Formatstring angeben, welche Argumenten welchen Platzhaltern entsprechen.
Wir würden dann den Formatstring wie folgt schreiben:
Argumente tauschen
]]>
Ein weiterer Vorteil ist, dass wir nun die Platzhalter wiederholen
können, ohne mehr Argumente im Code hinzufügen zu müssen. Zum Beispiel:
Argumente tauschen
]]>
args
...
&reftitle.returnvalues;
Gibt eine an Hand des Formatierungs-Strings format
gebildete Zeichenkette zurück.
&reftitle.changelog;
&Version;
&Description;
4.0.6
Unterstützung für Argument numbering/swapping hinzugefügt.
&reftitle.examples;
printf: Verschiedene Beispiele
]]>
&example.outputs;
printf: Stringformatierung
]]>
&example.outputs;
sprintf: Mit Nullen aufgefüllte Integer
]]>
sprintf: Währungsformatierung
]]>
sprintf: Wissenschaftliche Notation
]]>
&reftitle.seealso;
printf
sscanf
fscanf
vsprintf
number_format