API:System.AnsiStringT.FormatFloat

• Übergeordnet: AnsiStringT

C++

static AnsiStringT FormatFloat(const AnsiStringT& format,
                                          const long double& value) {

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	dstring.h	System	AnsiStringT

Beschreibung

Formatiert den mit value angegebenen Gleitkommawert. Dazu wird der im Parameter format übergebene Format-String verwendet.

System.AnsiStringT.FormatFloat erbt von System.AnsiStringBase.FormatFloat. Der folgende Inhalt bezieht sich auf System.AnsiStringBase.FormatFloat.

Formatiert den mit value angegebenen Gleitkommawert. Dazu wird der im Parameter format übergebene Format-String verwendet.

Die folgende Tabelle enthält die unterstützen Formatbezeichner:

Bezeichner	Bedeutung
0	Platzhalter für eine Ziffer. Enthält der zu formatierende Wert an der Position eine Ziffer, an der im Format-String '0' steht, wird diese in den Ausgabe-String kopiert. Andernfalls wird das Zeichen '0' an dieser Position im Ausgabe-String gespeichert.
#	Platzhalter für Ziffern. Enthält der zu formatierende Wert an der Position eine Ziffer, an der im Format-String '#' steht, wird diese in den Ausgabe-String kopiert. Andernfalls wird an dieser Position kein Zeichen im Ausgabe-String gespeichert.
.	Dezimalzeichen. Das erste Punktzeichen ('.') im Format-String bestimmt die Position des Dezimalzeichens im formatierten Wert. Alle weiteren Punktzeichen werden ignoriert. Welches Zeichen im Ausgabe-String tatsächlich als Dezimalzeichen verwendet wird, wird durch die globale Variable DecimalSeparator festgelegt, deren Standardwert auf dem Register Zahlen der Ländereinstellungen (bzw. Regions- und Sprachoptionen) in der Windows-Systemsteuerung festgelegt wird.
,	Tausendertrennzeichen. Enthält der Format-String ein oder mehrere ','-Zeichen, werden in den Ausgabe-String links vom Dezimalzeichen nach jeder Gruppe von drei Ziffern Tausendertrennzeichen eingefügt. Die Position und Anzahl der Trennzeichen im Format-String wirkt sich nicht auf die Ausgabe aus. Sie geben nur an, dass Trennzeichen eingefügt werden sollen. Welches Zeichen im Ausgabe-String tatsächlich als Tausendertrennzeichen verwendet wird, wird durch die globale Variable ThousandSeparator festgelegt, deren Standardwert auf dem Register Zahlen der Ländereinstellungen (bzw. Regions- und Sprachoptionen) in der Windows-Systemsteuerung festgelegt wird.
E+	Wissenschaftliche Notation. Sind die Zeichen 'E+', 'E-', 'e+' oder 'e-' im Format-String enthalten, wird die Zahl in der wissenschaftlichen Schreibweise formatiert. Bis zu vier '0'-Zeichen können direkt nach 'E+', 'E-', 'e+' oder 'e-' angegeben werden, um die minimale Anzahl der Stellen im Exponenten festzulegen. Bei den Formaten 'E+' und 'e+' wird für positive Exponenten ein Pluszeichen und für negative Exponenten ein Minuszeichen in den String eingefügt. Bei den Formaten 'E-' und 'e-' wird lediglich für negative Exponenten ein Vorzeichen ausgegeben.
'xx'/"xx"	In halbe oder ganze Anführungszeichen eingeschlossene Zeichen wirken sich nicht auf die Formatierung aus und werden wie eingegeben angezeigt.
;	Trennt Abschnitte für positive, negative und Nullwerte im Format-String.

Die Zeichen zwischen der äußersten linken '0' vor dem Dezimalzeichen und der äußersten rechten '0' nach dem Dezimalzeichen werden immer im Ausgabe-String angezeigt.

Die zu formatierende Zahl wird immer auf so viele Dezimalstellen gerundet, wie Ziffernplatzhalter ('0' oder '#') rechts des Dezimalzeichens vorhanden sind. Fehlt im Format-String ein Dezimalzeichen, wird der formatierte Wert auf die nächste ganze Zahl gerundet.

Hat die zu formatierende Zahl mehr Vorkommastellen, als Ziffernplatzhalter links des '.' im Format-String vorhanden sind, werden die zusätzlichen Stellen vor dem ersten Platzhalter ausgegeben.

Das Semikolon gliedert den Format-String in bis zu drei Abschnitte, in denen jeweils eine eigene Formatierung für positive und negative Zahlen sowie für Nullen definiert werden kann.

• Ein Abschnitt: Der Format-String wird für alle Werte verwendet.
• Zwei Abschnitte: Der erste Abschnitt wird für positive und Nullwerte, der zweite Abschnitt für negative Werte verwendet.
• Drei Abschnitte: Der erste Abschnitt wird für positive, der zweite für negative und der dritte Abschnitt für Nullwerte verwendet.

Wenn die Formatierung positiver Werte nicht definiert wird, werden positive Werte entsprechend dem allgemeinen Gleitkommaformat mit 15 signifikanten Stellen formatiert, was einem Aufruf von FloatToStrF mit dem Format sffGeneral entspricht. Die allgemeine Formatierung für Gleitkommawerte wird auch verwendet, wenn der Wert mehr als 18 Ziffern links neben dem Dezimalzeichen enthält und im Format-String keine wissenschaftliche Schreibweise festgelegt wurde.

Die folgende Tabelle zeigt einige Format-Strings und die verschiedenen Ergebnisse:

Format-String	1234	-1234	0,5
1234	-1234	0,5	0
0	1234	-1234	1
0.00	1234,00	-1234,00	0,50
#,##	1234	-1234	.5
#,##0.00	1.234,00	-1.234,00	0,50
#,##0.00;(#,##0.00)	1.234,00	(1.234,00)	0,50
#,##0.00;;Zero	1.234,00	-1.234,00	0,50
0.000E+00	1,234E+03	-1,234E+03	5,000E-01
#.###E-0	1,234E3	-1,234E3	5E-1