sprintf

(PHP 3, PHP 4 )

sprintf -- Gibt einen formatierten String zurück

Beschreibung:

string sprintf ( string format [, mixed args])

Gibt einen an Hand des Formatierungs-Strings format gebildeten String zurück.

Der Formatierungs-String wird aus keiner oder mehreren Anweisungen gebildet: Gewöhnliche Zeichen (ausser %), die direkt in das Ergebnis übertragen werden und Umsetzungs-Anweisungen. Jede dieser Anweisungen resultiert ihre eigene Auswirkung. 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 (in alphabetischer Reihenfolge):

  1. Einem optionalen Füll-Zeichen, das den String bis rechts auffüllt. Dies kann ein Leerzeichen oder eine 0 (das Null-Zeichen) sein. Als Füllzeichen voreingestellt ist das Leerzeichen. Andere Füllzeichen können durch Voranstellung eines einfachen Anführungszeichens (') definiert werden. Beachten Sie die folgenden Beispiele.

  2. Einer optionalen Angabe der Ausrichtung, ob die Ausgabe also nach links oder nach rechts (default) ausgerichtet werden soll. Um den Text links auszurichten müssen Sie das Zeichen - angeben.

  3. Optional einem Wert für die Längen-Angabe, also der Wert für die mindestenst zurückzugebenden Zeichen.

  4. Optional einem Wert für die Anzahl der auszugebenden Nachkomma-Stellen. Dieser Wert hat nur Einfluss auf Werte vom Typ "double" (eine weitere hilfreiche Funktion für die Formatierung von Zahlen ist number_format()).

  5. Einer Typ-Angabe welche den Typ enthält, als der das Argument angesehen werden soll. Mögliche Angaben sind:

    % - ein Prozent-Zeichen ("%"). 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 ein Dezimalwert ausgegeben.
    f - das Argument wird als "double" angesehen und eine Fließkomma-Zahl ausgegeben.
    o - das Argument wird als Integer angesehen und und als Oktalwert ausgegeben.
    s - das Argument wird als String angesehen und als solcher ausgegeben.
    x - das Argument wird als Integer angesehen und als Hexadezimal-Wert ausgegeben (mit Kleinbuchstaben).
    X - das Argument wird als Integer angesehen und als Hexadezimal-Wert ausgegeben (mit Großbuchstaben).

Siehe auch: printf(), sscanf(), fscanf() und number_format().

Beispiele:

Beispiel 1. sprintf(): Null-gefüllte Integer-Werte

$isodatum = sprintf ("%04d-%02d-%02d", $jahr, $monat, $tag);

Beispiel 2. sprintf(): Integer- zu Binärwert

$wert = 155;
$binaer = sprintf ("%b", $wert);
echo ("<br> $binaer <br>");
// gibt 10011011 aus

Beispiel 3. sprintf(): Währungsformatierung

$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money wird "123.1" ausgeben
$formatiert = sprintf ("%01.2f", $money);
// echo $formatiert wird "123.10" ausgeben