Python-Kurs

Formatierte Ausgabe

Wege die Ausgabe zu formatieren

In diesem Kapitel unseres Python-Tutorials werden wir uns intensiv mit den verschiedenen Methoden beschäftigen, mit denen man die Ausgaben formatieren bzw. formatierte Strings erzeugen kann. Wir stellen die verschiedenen Arten vor, aber wir empfehlen die format-Methode der Stringklasse zu benutzen, die sich kurz vor Ende des Kapitels befindet. Die format-Methode ist die bei weitem flexibelste.

Bisher hatten wir die print-Funktion auf zwei Arten benutzt, wenn wir beispielsweise zwei Werte ausgeben wollten:

Die einfachste Art, aber sicherlich nicht die eleganteste: Wir benutzen print mit einer kommaseparierten Liste von Werten, um die Ergebnisse auszugeben, wie wir im folgenden Beispiel sehen können. Alle Werte werden durch Leerzeichen getrennt, was dem Default-Verhalten entspricht. Wir können die Default-Trennung durch einen beliebigen String ersetzen. Dazu müssen wir diesen String lediglich durch den Schlüsselwort-Parameter "sep" der Print-Funktion ersetzen:

Alternativ können wir auch aus den Werten mittels der String-Konkatenation einen neuen String konstruieren:

Die zweite Methode ist schlechter, - da komplizierter, - als die erste.

Die alte Methode im Stil von printf und sprintf

Statt "alte" Methode sollten wir besser "veraltete" Methode sagen, da dieses Vorgehen keinen guten Python-Stil mehr darstellt.

Gibt es ein printf in Python? Das ist die brennende Frage für Python-Anfänger, die von C, Perl, Bash oder anderen Programmiersprachen kommen, die dieses Statement bzw. diese Funktion benutzen. Zu sagen, dass Python eine print-Funktion und keine printf-Funktion hat ist nur die eine Seite der Medaille. Also gibt es doch eine "printf"-Funktion in Python? Nein, aber die Funktionalität des "alten" printf wurde in anderer Form übernommen. Zu diesem Zweck wird der Modulo-Operator "%" von der String-Klasse überladen. Deshalb spricht man bei dem überladenen Operator "%" der String-Klasse auch häufig vom String-Modulo-Operator, obwohl es eigentlich wenig mit der eigentlich Modulo-Arithmetik zu tun hat. Manchmal wird er auch synonym als String-Modulus-Operator genannt. Ein weiterer Begriff, für diese Operation lautet "String-Interpolation", weil bei dieser Operation Werte, wie Integers, Floats usw., in den zu erzeugenden formatierten String eingefügt also interpoliert werden. Den mittels der String-Interpolation erzeugten formatierten String, kann man dann z.B. mittels print (also nicht printf) ausgeben. Aber man kann diesen formatierten String auch auf andere Art im Programm weiter verwenden, wie ihn zum Beispiel in eine Datenbank übertragen. Seit Python 2.6 eingeführt worden ist, wird jedoch von der Python-Gemeinde empfohlen die String-Methode "format" stattdessen zu verwenden. Unglücklicherweise konnten man sich auch bei dem Design von Python3 nicht von der veralteten String-Interpolations-Methode trennen. Außerdem wird die veraltete Methode noch allzu häufig benutzt. Aus diesem Grunde gehen wir auch in unserem Tutorial ausgiebig darauf ein. Um fremden Python-Code verstehen zu können, der die String-Interpolations-Methode benutzt, ist es nötig den Mechanismus zu verstehen. Wahrscheinlich - oder hoffentlich - wird man sich jedoch bei der Weiterentwicklung von Python eines Tages von dieser Methode trennen.

Das folgende Diagramm verbildlicht die Arbeitsweise des String-Modulo-Operators:

Auf der linken Seite des String-Modulo-Operators befindet sich der sogenannte Format-String und auf der rechten Seite steht ein Tupel mit den Werten, die in den Format-String interpoliert bzw. eingefügt werden sollen. Die Werte können Literale, Variablen oder beliebige arithmetische Ausdrücke sein.

Der Formatstring enthält Platzhalter. In unserem Beispiel befinden sich zwei davon: "%5d" und "%8.2f".

Die allgemeine Syntax für diese Platzhalter lautet:

    %[flags][width][.precision]type 

Schauen wir uns einmal die Platzhalter unseres Beispieles genauer an: Der zweite, also "%8.2f", ist eine Formatbeschreibung für eine Floatzahl. Wie auch alle anderen Platzhalter wird er durch ein "%"-Zeichen eingeleitet. Dieses wird von einer Zahl gefolgt, die die totale Anzahl der Zeichen angibt, mit der die Zahl ausgegeben werden soll. Diese Anzahl beinhaltet auch den Dezimalpunkt und alle Ziffern vor und nach dem Punkt. Unsere Floatzahl 59.058 muss also mit 8 Zeichen dargestellt werden. Der Dezimalanteil der Zahl ist auf 2 gesetzt, dies ist die Zahl hinter dem "." beim Platzhalter. Das bedeutet, dass die Anzahl der Nachkommastellen auf 2 gesetzt ist. Das letzte Zeichen im Platzhalt ist der Buchstabe "f". Wie sich leicht vermuten lässt, steht er für "float".

Schaut man sich die Ausgabe an, erkennt man, dass die Zahl "59.058" als " 59.06" ausgegeben wird. Man sieht auch, dass die Ausgabe nicht etwa nach zwei Stellen abgebrochen wird, sondern dass eine Rundung erfolgt. Außerdem werden von links drei Leerzeichen an die Zahl bei der Ausgabe angefügt.

Der erste Platzhalter "%5d" dient als Beschreibung für die erste Komponente unseres Tupels, d.h. die Ganzzahl (integer) 453. Diese Zahl soll mit 5 Zeichen ausgedruckt werden. Da 453 aber nur aus 3 Stellen besteht, werden der Zahl in der Ausgabe zwei Leerzeichen vorangestellt. Viele werden statt "%5d" einen Platzhalter der Art "%5i" erwartet haben, da es sich ja um eine Integer-Zahl handelt. Worin besteht der Unterschied? Ganz einfach: Es gibt keinen Unterschied zwischen "d" und "i". Beide werden zur Formatierung von Integers genutzt.

Die Vorteile bzw. die Schönheit der formatierten Ausgabe kann man nur ermessen, wenn man mehrere gleichermaßen formatierte Ausgaben ausgibt. Im folgenden Beispiel zeigen wir, wie es aussieht, wenn wir 5 Fließzahlen (floats) gleich formatiert mit dem Platzhalter "%6.2f" in verschiedenen Zeilen ausgeben:

Die folgenden Beispiele zeigen einige exemplarische Anwendungen der Konvertierungsmöglichkeiten der vorigen Tabelle:

Beispiele:

Obwohl es so ausschauen mag, ist die Formatierung nicht Teil der Print-Funktion. Schaut man sich die vorigen Beispiele genauer an, sieht man, dass wir einen formatierten String an die Print-Funktion übergeben haben. Oder anders ausgedrückt: Wenn die String-Interpolation auf einen String angewendet wird, liefert sie einen String zurück. Dieser String wird dann an print übergeben. Dies bedeutet wiederum, dass wir die String-Interpolation auch hätten "zweistufig" anwenden können, d.h. wir hätten erst einen formatierten String erzeugt, diesen einer Variablen zugewiesen und diese Variable dann an print übergeben:

Der pythonische Weg: Die String-Methode "format"

Was die String-Methode format betrifft, ist die help-Funktion von Python nicht sehr hilfreich. Alles was sie uns sagt, ist dieses:

| format(...)
| S.format(*args, **kwargs) -> str
|

| Return a formatted version of S, using substitutions from args and kwargs.
| The substitutions are identified by braces ('{' and '}').
|

Die String-Methode "format" wurde mit Python 2.6 als Ersatz für die String-Interpolation eingeführt.

Ganz allgemein sieht "format" wie folgt aus:

template.format(p0, p1, ..., k0=v0, k1=v1, ...)

Der Format-String ist ein String, der ein oder mehrere Format-Codes innerhalb eines konstanten Textes enthält, d.h. Felder, die ersetzt werden sollen. Die zu "ersetzenden Felder" sind von geschweiften Klammern umgeben. Eine geschweifte Klammer und der von ihr umschlossene "Code" wird mit dem formatierten Wert aus dem korrespondierenden Argument ersetzt. Nach welchen Regeln dies zu erfolgen hat, werden wir im folgenden erläutern. Alles andere, was nicht von geschweiften Klammern umschlossen ist, wird wörtlich, also ohne Änderungen, ausgedruckt. Möchte man eine öffnende oder eine schließende geschweifte Klammer ausgeben, muss man diese verdoppeln, also "{{" oder "}}".

Es gibt zwei Arten von Argumenten für die format-Methode. Die Argumentenliste startet mit 0 oder mehr Positionsargumenten (p0, p1, ...), die von 0 oder mehr Schlüsselwortargumenten der Form name=value gefolgt werden können.

Ein Positionsparameter der format-Methode kann benutzt werden, indem man den Index des Parameters nach öffnenden geschweiften Klammer angibt, d.h. {0} für den ersten Parameter, {1} für den zweiten und so weiter. Der Index des Positionsparameter nach der öffnenden geschweiften Klammer kann von einem Doppelpunkt und einem Formatstring gefolgt werden, der dem des String-Interpolationsparameters ähnelt, den wir zu Beginn des Kapitels besprochen hatten, also zum Beispiel {0:5d} Falls die Positionsparameter in der Reihenfolge benutzt werden, in der sie in der Parameterliste stehen, kann die Angabe des Indexes innerhalb der geschweiften Klammern entfallen, d.h. '{} {} {}' entspricht '{0} {1} {2}'. Um es nochmals klar zu stellen: Will man sie in einer anderen Reihenfolge benutzen, sind die Angaben der Indexpositionen dringend notwendig, wie z.B. hier '{2} {1} {0}'

Im folgenden Diagramm zeigen wir anhand eines Beispieles wie die Stringmethode "format" für zwei Parameter funktioniert:

Beispiele mit Positionsparametern:

Im folgenden Beispiel demonstrieren wir, wie Schlüsselwortparameter mit der format-Methode benutzt werden können:

Mit der format-Methode ist es auch möglich Daten links- und rechtsbündig auszugeben. Dazu müssen wir der Formatierungsanweisung ein "<" (linksbündig) oder ein ">" (rechtsbündig) voranstellen. Wir demonstrieren dies an den folgenden Beispielausgaben:

If the width field is preceded by a zero ('0') character,
sign-aware zero-padding for numeric types will be enabled.

Wenn keine minimale Feldlänge angegeben wird, entspricht die Feldlänge immer der Länge der Daten, die ein Feld enthält. In diesen Fällen haben die Ausrichtungsoptionen keine Bedeutung.

Zusätzlich können wir noch die Ausgabe mittels der sign-Option beeinflussen. Diese Optionen sind nur für numerische Werte gültig:

Benutzung von Dictionaries beim Aufruf der "format"-Methode

In den vorigen Kapitel haben wir gesehen, dass wir zwei Möglichkeiten haben Werte mit "format" zu formatieren:

• Benutzung des Index bzw. der Position des Argumentes:

Um es nochmals zu erwähnen: Im vorigen Beispiel hätten wir auch geschweifte Klammern mit leeren Inhalt benutzen können!

• Benutzung von Schlüsselwort-Parametern:

Im zweiten Fall könnten wir auch ein Dictionary verwenden, wie wir im folgenden Code sehen können:

Das doppelte Sternchen ("*") vor data wandelt data automatisch in die Form 'province="Ontario",capital="Toronto"'. Schauen wir uns das folgende Python-Programm an:

Das vorige Programm können wir so umschreiben, dass im Aufruf der format-Methode das Dictionary direkt verwendet wird.

Der Ausdruck ist gleich wie beim ersten Programm.

Benutzung von lokalen Variablen in "format"

"locals" ist eine Funktion, die ein Dictionary mit den lokal definierten Namen und ihren aktuellen Werten zurückliefert. Die Variablen sind die Schlüssel dieses Dictionary und die Werte zu den Schlüsseln entsprechen den Werten der Variablen:

Das Dictionary, was von locals() zurückgeliegert wird, kann als Parameter für die format-Methode genutzt werden. Dadurch ist es möglich im Format-String lokale Variablen zu verwenden.

Im folgenden Beispiel benutzen wir die lokalen Variablen a, b und f:

Weitere String-Methoden zum Formatieren

Die String-Klasse enthält weitere Methoden, die man auch zu Formatierungszwecken nutzen kann: ljust, rjust, center und zfill.

Falls S ein String ist, können wir die vier Methoden wie folgt erklären:

• center(...):

    S.center(width[, fillchar]) -> str
  

  An den String S werden links und rechts Füllzeichen bis zur Länge "width" so angefügt, dass der ursprüngliche String zentriert wird. Wird für das Füllzeichen "fillchar" kein Wert angegeben, wird als Standardwert ein Leerzeichen verwendet.

*Beispiele:

• ljust(...):

     S.ljust(width[, fillchar]) -> str 
  

  Der String S wird linksbündig zurückgeliefert. Rechts wird der String mit Füllzeichen "fillchar" bis zur Länge "width" angefüllt. Auch hier ist ein Leerzeichen der Default-Wert für "fillchar".

*Beispiele:

• rjust(...):

    S.rjust(width[, fillchar]) -> str

Der String S wird rechtsbündig zurückgeliefert. Von links wird der String mit Füllzeichen "fillchar" bis zur Länge "width" angefüllt. Auch hier ist ein Leerzeichen der Default-Wert für "fillchar".

*Beispiele:

• zfill(...):

    
    S.zfill(width) -> str

Ein String S wird von links mit Nullen bis zu der Länge "width" aufgefüllt. Der String " wird nicht abgeschnitten, falls er bereits länger als die vorgesehen Länge "width" ist. Diese Methode entspricht einem S.rjust(width, "0")

*Beispiele: