Formatierungsanweisungen

Skripte > Klassen-Elemente und C++-Befehle > Formatierungsanweisungen

Formatierungsanweisungen werden verwendet, um das Aussehen des generierten Zieltextes zu bestimmen. (Siehe auch Einrückungen)

In den Interpreter ist die Boost Format library von Samuell Krempp integriert, mittels derer Argumente gemäß einem Format-String formatiert werden (ähnlich der Funktionsweiese von printf in C).

Die Syntax des Format-Strings und die zu ihm passende Anzahl der Argumente wird vor der Ausführung der Formatierungsanweisung nicht überprüft.

Hinweis: Die folgenden Erklärungen sind im wesentlichen auf die Darstellung der "%|spec|" Spezifikation beschränkt. Zusätzliche Möglichkeiten, die sich enger an die traditionelle printf-Syntax anlehnen, können der Originaldokumentation entnommen werden.

Aus einem Format-String wird ein Objekt erzeugt, dem durch wiederholten Aufruf von operator% Argumente übergeben werden. Jedes dieser Argumente wird in einen String konvertiert, der dann wiederum entsprechend dem Formatstring mit den Strings der anderen Argumente zu einen Gesamtstring kombiniert wird.

out << format("writing %|1$|,  x=%|2$| : %|3$|-th try")

                       % "toto" % 40.23 % 50;

// ergibt: "writing toto,  x=40.230 : 50-th try"

Diese Seite gehört zur TextTransformer Dokumentation