Format Strings für Meldungstexte

log4TC unterstütz mehrer Arten von Platzhaltern in Meldungstexten, entweder Positionsargumente oder benannte Argumente. Es gelten folgende Regeln:

• Argumten werden zwischen { und } Klammern geschrieben
• Die Klammern selbst können durch Verdopplung geschützt werden; {{ wird zu {
• Wenn alle Argumente nummeriert sind, wie z.B. {0}, {1} usw., dann werden die Argumentwerte gemäss der Nummer zugeordnet, also {0} verwendet den 1. Wert usw.
• Ist mindestens ein benanntest Argumente dabei wie z.B. {index} dann werden die Argumentwerte gemäss der Reihenfolge wie sie im Text vorkommen zugeordnet.
• Argumente können noch mit Optionen formatiert werden

Beispiel:

'Die Verarbeitung von {0} wurde {1} abgeschlossen'
'Die Verarbeitung von {typ} wurde {status} abgeschlossen'

Optionen für Argumente

Sowohl für positions als auch für benannte Argumente können noch weiter Optionen angegeben werden. Details dazu finden sich in Composite Format String, nachfolgend aber eine Übersicht mit den wichtigsten Optionen.

Der grundlegende Aufbau ist wie folgt:

{Index[,Ausrichtung][:Format]}

bzw.

{Name[,Ausrichtung][:Format]}

Index oder Name ist entweder die Argument-Nr (0-basiert) oder der Argument Name. Beispiel: Von {0} bis {1}; Von {startTime} bis {endTime}.

Die Option Ausrichtung ist eine Ganzzahl mit Vorzeichen, welche die bevorzugte Grösse in Zeichen für die Ausgabe angibt. Positive Werte führen zu einer rechtsbündigen Ausrichtung, negative Werte zu einer linksbündigen. Beispiel:

• '({0,5})' {0}=42 => '( 42)'
• '({0,-5})' {0}=42 => '(42 )'

Die Option Format bestimmt wie der Typ des Arguments formattiert wird.

Beispiel für Zahlen:

• Decimal: ({0:D4})' {0}=42 => '(0042)' Nur für Ganzzahltypen. Parameter: Minium Anzahl Ziffern.
• Exponential: ({0:E2})' {0}=42 => '(4.20E+001)' Parameter: Anzahl Nachkommastellen
• Fixed-point: ({0:F2})' {0}=42 => '(42.00)' Parameter: Anzahl Nachkommastellen
• Number: ({0:N2})' {0}=4200 => '(4’200.00)' Mit Gruppentrenner. Parameter: Anzahl Nachkommstellen
• Percent: ({0:P1})' {0}=0.42 => '(42.0%)' Parameter: Anzahl Nachkommstellen
• Hexadecimal: ({0:X4})' {0}=42 => '(002A)' Nur für Ganzzahltypen.