StringFormat - Versionsgeschichte

Jankowski am 13. März 2009 um 11:09 Uhr

2009-03-13T11:09:30Z

Jankowski: /* Beschreibung */

2009-03-13T11:03:50Z

Beschreibung

Veltrup: Die Seite wurde neu angelegt: ==Beschreibung== Mit dem Stringformat lassen sich Zeichenketten in einem bestimmten Format ausgeben. Ein Stringformat besteht aus einer Zeichenkette, die Platzhalter en...

2008-11-07T11:02:58Z

Die Seite wurde neu angelegt: ==Beschreibung== Mit dem Stringformat lassen sich Zeichenketten in einem bestimmten Format ausgeben. Ein Stringformat besteht aus einer Zeichenkette, die Platzhalter en...

Neue Seite

==Beschreibung==
Mit dem Stringformat lassen sich Zeichenketten in einem bestimmten Format ausgeben. Ein Stringformat besteht aus einer Zeichenkette, die Platzhalter enthält. Diese Platzhalter werden durch Werte ersetzt. Die Platzhalter können durch verschiedene Muster beschrieben werden, um die Formatierung der einzufügenden Werte zu definieren.

Hier ein Beispiel für eine Zeichnkette mit enthaltenen Formatierungszeichen:
<source lang="text">
Hier ist eine Nummer-%4d-und ein -%10s-Wort.
</source>
Für die Formatierung werden für dieses Beispiel zwei Werte benötigt, die in die Zeichenkette eingesetzt werden sollen. Werden Beispielsweise die Werte <code>5</code> und <code>'kleines'</code> verwendet, ergibt sich daraus folgende formatierte Zeichenkette
<source lang="text">
Hier ist eine Nummer- 5-und ein - kleines-Wort.
</source>

==Formatierungszeichen==
Die Formatierungszeichen können aus bis zu 6 Teilen bestehen, siehe Tabelle unten. Sie müssen in der hier verwendeten Reihenfolge benutzt werden.

{| class="prettytable"
|- class="hintergrundfarbe1"
! % || Flags || Minimaler Platz || Punkt || Genauigkeit || Typ
|-
| erforderlich
| optional
| optional
| optional
| optional
| erforderlich
|}

===%===
<code>%</code> markiert den Beginn der Formatierungssymbole und ist zwingend erforderlich.

===Flags===
Formatbezeichner können mit Hilfe folgender Flags variiert werden.
{| class="prettytable"
|- class="hintergrundfarbe1"
! Flag || Beschreibung
|-
| <code>-</code>
| linksbündig
|-
| <code>0</code>
| Felder mit 0 ausfüllen (an Stelle von Leerzeichen).
|-
| <code>+</code>
| Vorzeichen einer Zahl immer ausgeben.
|-
| ''Leerzeichen''
| positive Zahlen mit Leerzeichen beginnen.
|-
| <code>#</code>
| Je nach angegebenem Typ had dieses Flag verschiedene Bedeutungen
<code>%#o</code> (Oktal) 0 Präfix wird eingefügt. 
<code>%#x</code> (Hex) 0x Präfix wird bei Werten ungl. Null eingefügt. 
<code>%#X</code> (Hex) 0X Präfix wird bei Werten ungl. Null eingefügt. 
<code>%#e</code> Dezimalpunkt immer anzeigen. 
<code>%#E</code> Dezimalpunkt immer anzeigen. 
<code>%#f</code> Dezimalpunkt immer anzeigen. 
<code>%#g</code> Dezimalpunkt immer anzeigen. Nullen nach dem Dezimalpunkt werden nicht beseitigt. 
<code>%#G</code> Dezimalpunkt immer anzeigen. Nullen nach dem Dezimalpunkt werden nicht beseitigt. 
|}

===Minimaler Platz===
Standardmäßig wird die Anzahl der Felder so gewählt, daß der für die Ausgabe benötigte Platz minimal ist. Es kann aber eine Zahl angegeben werden, die bestimmt wieviele Zeichen für den einzusetzenden Wert minimal ausgegeben werden sollen. Besitzt der Wert weniger Zeichen wird der Rest mit Leerzeichen aufgefüllt. Die Werte werden rechtsbündig ausgegeben (Die Leerzeichen werden vor den Wert gesetzt). Mit Hilfe des <code>-</code> Flag kann man sie auch linksbündig ausgeben.

===Punkt===
Wenn man die Genauigkeit (d.h. die Anzahl der Nachkommastellen) festlegen will, muss diesem Wert ein Punkt vorangestellt werden.

===Genauigkeit===
<source lang="text">
%8.2f
</source>
Heißt z.B., dass ein Bereich von 8 Zeichen für die Ausgabe reserviert werden soll. Die letzten beiden stellen werden für die Nachkommastellen reserviert.
<source lang="text">
%.2f
</source>
Es wird ein Bereich mit mindestens 2 Zeichen bereitgestellt und für Nachkommastellen reserviert.

===Typ===
Der Typ beschreiben die zur Ausgabe erwarteten Daten. Mit dem Typ wird die Formatierungsbeschreibung für einen Wert abgeschlossen. Folgende Typen können angegeben werden:

{| class="prettytable"
|- class="hintergrundfarbe1"
! Typ || Beschreibung
|-
| <code>s</code>
| Es wird ein String erwartet
|-
| <code>d</code>
| Es wird ein dezimaler Integer erwartet
|-
| <code>o</code>
| Es wird eine Oktalzahl erwartet
|-
| <code>x</code> oder <code>X</code>
| Es wird eine Hexdezimalzahl erwartet
|-
| <code>f</code>
| Es wird eine dezimale Fliesskommazahl erwartet
|-
| <code>%</code>
| Gibt ein <code>%</code> aus.
|-
| <code>n</code>
| Gibt einen Zeilenumbruch aus.
|}

<noinclude>
[[Category:SPML]]
[[Category:Qualität_der_Sprache_prüfen]]
[[Category:Qualität_des_Codes_prüfen]]
</noinclude>

@@ Zeile 60: / Zeile 60: @@
 ===Minimaler Platz===
-Standardmäßig wird die Anzahl der Felder so gewählt, daß der für die Ausgabe benötigte Platz minimal ist. Es kann aber eine Zahl angegeben werden, die bestimmt wieviele Zeichen für den einzusetzenden Wert minimal ausgegeben werden sollen. Besitzt der Wert weniger Zeichen wird der Rest mit Leerzeichen aufgefüllt. Die Werte werden rechtsbündig ausgegeben (Die Leerzeichen werden vor den Wert gesetzt). Mit Hilfe des <code>-</code> Flag kann man sie auch linksbündig ausgeben.
+Standardmäßig wird die Anzahl der Felder so gewählt, dass der für die Ausgabe benötigte Platz minimal ist. Es kann aber eine Zahl angegeben werden, die bestimmt, wieviele Zeichen für den einzusetzenden Wert minimal ausgegeben werden sollen. Beinhaltet der Wert weniger Zeichen, wird der Rest mit Leerzeichen aufgefüllt. Die Werte werden rechtsbündig ausgegeben (Die Leerzeichen werden vor den Wert gesetzt). Mit Hilfe des <code>-</code> Flag können diese auch linksbündig ausgeben werden.
 ===Punkt===
@@ Zeile 69: / Zeile 69: @@
 %8.2f
 </source>
-Heißt z.B., dass ein Bereich von 8 Zeichen für die Ausgabe reserviert werden soll. Die letzten beiden stellen werden für die Nachkommastellen reserviert.
+Heißt z.B., dass ein Bereich von 8 Zeichen für die Ausgabe reserviert werden soll. Die letzten beiden Stellen werden für die Nachkommastellen reserviert.
 <source lang="text">
 %.2f
@@ Zeile 86: / Zeile 86: @@
 |-
 | <code>d</code>
-| Es wird ein dezimaler Integer erwartet
+| Es wird ein dezimaler Integer-Wert erwartet
 |-
 | <code>o</code>
@@ Zeile 95: / Zeile 95: @@
 |-
 | <code>f</code>
-| Es wird eine dezimale Fliesskommazahl erwartet
+| Es wird eine dezimale Fließkommazahl erwartet
 |-
 | <code>%</code>
@@ Zeile 106: / Zeile 106: @@
 <noinclude>
 [[Category:SPML]]
 [[Category:Qualität_des_Codes_prüfen]]
 </noinclude>

@@ Zeile 2: / Zeile 2: @@
 Mit dem Stringformat lassen sich Zeichenketten in einem bestimmten Format ausgeben. Ein Stringformat besteht aus einer Zeichenkette, die Platzhalter enthält. Diese Platzhalter werden durch Werte ersetzt. Die Platzhalter können durch verschiedene Muster beschrieben werden, um die Formatierung der einzufügenden Werte zu definieren.
-Hier ein Beispiel für eine Zeichnkette mit enthaltenen Formatierungszeichen:
+Hier ein Beispiel für eine Zeichenkette mit enthaltenen Formatierungszeichen:
 <source lang="text">
 Hier ist eine Nummer-%4d-und ein -%10s-Wort.
 </source>
-Für die Formatierung werden für dieses Beispiel zwei Werte benötigt, die in die Zeichenkette eingesetzt werden sollen. Werden Beispielsweise die Werte <code>5</code> und <code>'kleines'</code> verwendet, ergibt sich daraus folgende formatierte Zeichenkette
+Für die Formatierung werden für dieses Beispiel zwei Werte benötigt, die in die Zeichenkette eingesetzt werden sollen. Werden beispielsweise die Werte <code>5</code> und <code>'kleines'</code> verwendet, ergibt sich daraus folgende formatierte Zeichenkette
 <source lang="text">
 Hier ist eine Nummer-   5-und ein -   kleines-Wort.