mitmario.dev

Text formatieren

PHP Sandbox 4 Min Lesezeit 4 BeispieleLektion 4 von 7

In $betragCent steht 123450, und ein echo gibt 123450 aus, ohne Komma und ohne Punkt. Auf einer Rechnung will das niemand lesen. Dort soll 1.234,50 stehen, und dazwischen liegen ein Teiler und zwei Trennzeichen.

Beträge in deutscher Schreibweise

Ein Betrag in deutscher Schreibweise
<?php

$betragCent = 123450;

echo "In Cent:               ", $betragCent, "\n";
echo "Zwei Nachkommastellen: ", number_format($betragCent / 100, 2), "\n";
echo "Deutsche Schreibweise: ", number_format($betragCent / 100, 2, ",", "."), "\n";
echo "Ganz ohne Nachkomma:   ", number_format($betragCent / 100, 0, ",", "."), "\n";

number_format kennst du aus Lektion 2.3, dort mit zwei Argumenten, dem Wert und der Zahl der Nachkommastellen. Heraus kam die englische Schreibweise. Den Punkt vor den Cent sieht man schon an 47.50, und über tausend kommt noch das Komma als Tausendertrenner dazu. number_format($betragCent / 100, 2) ergibt 1,234.50.

In Deutschland ist beides vertauscht. Deshalb nimmt die Funktion zwei weitere Argumente, erst das Zeichen vor den Nachkommastellen, dann das für die Tausendertrennung. number_format($betragCent / 100, 2, ",", ".") ergibt 1.234,50, und so steht ein Betrag im ganzen Kurs da.

In der letzten Zeile kommt mit 0 Nachkommastellen 1.235 heraus und nicht 1.234, denn number_format rundet und schneidet nicht ab. Bei Beträgen ist das richtig so. Willst du eine Zahl nur kürzer anzeigen, bekommst du dabei eine andere.

Platzhalter statt Zusammenkleben

Platzhalter statt Zusammenkleben
<?php

$name = "Mia";
$anzahl = 3;
$preisCent = 450;

printf("%s hat %d Stück gekauft.\n", $name, $anzahl);
printf("Einzelpreis: %.2f Euro\n", $preisCent / 100);
printf("Bestellnummer: %05d\n", 42);
printf("Rabatt: 10%%\n");

Mit dem Punkt kannst du ganze Sätze zusammensetzen, aber sobald mehr als zwei Werte hineingehören, wird das unübersichtlich. printf nimmt den Satz einmal am Stück, mit Platzhaltern an den Stellen, an denen Werte hingehören. Die Werte selbst kommen danach als weitere Argumente.

Vier Platzhalter kommen im Kurs vor. %s steht für Text, und alles, was kein Text ist, wird dafür zu einem gemacht. %d steht für eine ganze Zahl. %.2f steht für eine Kommazahl mit zwei Nachkommastellen. Das klingt erst mal nach number_format, arbeitet aber ohne Tausendertrenner und immer mit Punkt. Für Beträge bleibt number_format deshalb die bessere Wahl. Und %05d heißt „ganze Zahl, mindestens fünf Stellen, vorne mit Nullen aufgefüllt“. Mit %02d werden es zwei Stellen, und so steht die Uhrzeit, die beim Rechnen als 2:5:3 herauskam, als 2:05:03 da.

Ein Prozentzeichen im Text schreibst du als %%, sonst hält PHP es für den Anfang eines Platzhalters. Daneben gibt es sprintf, das denselben Text zurückgibt, statt ihn auszugeben.

Spalten, die untereinander stehen

Eine Tabelle, die ausgerichtet steht
<?php

$lampeCent = 4990;
$teppichCent = 129900;
$summeCent = $lampeCent + $teppichCent;

printf("%-10s%10s Euro\n", "Lampe", number_format($lampeCent / 100, 2, ",", "."));
printf("%-10s%10s Euro\n", "Teppich", number_format($teppichCent / 100, 2, ",", "."));
printf("%-10s%10s Euro\n", "Summe", number_format($summeCent / 100, 2, ",", "."));

Eine Zahl im Platzhalter kann auch festlegen, wie breit die Spalte wird. %10s heißt „mindestens zehn Zeichen breit, der Text steht rechts“. Mit einem Minuszeichen dreht sich das um, %-10s schiebt den Text nach links und füllt rechts auf.

So entsteht auf der Kommandozeile eine Tabelle, mit einem printf je Zeile. Namen links, Beträge rechts. Die Beträge stehen rechtsbündig, also liegen Komma und Cent-Stellen untereinander. Bei einer Zahlenkolonne ist das der Unterschied zwischen lesbar und nicht lesbar.

Dasselbe geht mit str_pad($text, 10), das rechts auffüllt, und beide Wege führen zum selben Ergebnis. Für die andere Richtung kommt STR_PAD_LEFT erst an vierter Stelle, denn davor steht das Füllzeichen. Also str_pad($betrag, 10, " ", STR_PAD_LEFT). Fehlt das Leerzeichen dazwischen, füllt PHP mit Nullen auf, weil es die Konstante für das Füllzeichen hält.

Ein Umlaut verschiebt die Spalte

Warum ein Umlaut die Spalte verschiebt
<?php

printf("[%-14s] fertig\n", "Schreibtisch");
printf("[%-14s] fertig\n", "Buerostuhl");
printf("[%-14s] fertig\n", "Bürostuhl");

echo "\n";
echo "Bürostuhl hat ", mb_strlen("Bürostuhl"), " Zeichen,\n";
echo "aber ", strlen("Bürostuhl"), " Bytes.\n";

In den ersten beiden Zeilen steht die schließende Klammer an derselben Stelle, in der dritten eine Position weiter links.

Schuld ist der Unterschied zwischen Zeichen und Bytes, und hier richtet er zum ersten Mal wirklich etwas an. %-14s und str_pad zählen Bytes, nicht Zeichen. Bürostuhl hat neun Zeichen, belegt aber zehn Bytes, weil das ü zwei davon braucht. PHP füllt also auf vierzehn Bytes auf, und zu sehen sind dann nur dreizehn Zeichen.

Bei einer Namensliste mit Umlauten franst die schönste Tabelle auf der rechten Seite aus, und zwar unterschiedlich weit, je nachdem, wie viele Umlaute in einer Zeile stecken. Seit PHP 8.3 gibt es mb_str_pad, das richtig zählt. Der Code des Kurses läuft aber schon auf PHP 8.2, und dort fehlt die Funktion. Deshalb steht sie in keiner Lösung. Die Maschine im Kurs ist neuer, und welche Version sie hat, zeigt php --version im Terminal. Dort setzt php -r 'echo "[", mb_str_pad("Bürostuhl", 14), "]", PHP_EOL;' die Klammer an dieselbe Stelle wie bei den beiden Zeilen ohne Umlaut.

Im Browser hast du das Problem nicht. Eine HTML-Tabelle richtet sich dort von selbst aus.

In der Aufgabe stehen deshalb nur Posten ohne Umlaut, ein Schreibtisch und ein Regal samt Summe.

Zum Mitnehmen

number_format schreibt einen Betrag mit Komma und Tausenderpunkt, wenn es beide Zeichen mitbekommt, und rundet dabei. printf setzt Werte in Platzhalter und richtet Spalten aus, zählt dafür aber Bytes, also rutscht eine Zeile mit Umlaut aus der Spalte.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 4 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.