Core.Printf-Modul (F#)
Aktualisiert: April 2011
Erweiterbare printf-Formatierung für Zahlen und andere Datentypen.
Namespace/Modulpfad: Microsoft.FSharp.Core
Assembly: FSharp.Core (in FSharp.Core.dll)
module Printf
Hinweise
Formatangaben sind Zeichenfolgen mit %-Markierungen, die Formatplatzhalter angeben. Formatplatzhalter bestehen aus folgenden Elementen: %[flags][width][.precision][type], wobei der Typ wie in der folgenden Tabelle interpretiert wird:
Typ |
Beschreibung |
|---|---|
%b |
Formatiert einen bool, der als true oder false formatiert wurde. |
%s |
Formatiert einen string, der ohne die Interpretation von Escapezeichen als sein Inhalt formatiert ist. |
%d, %i |
Formatiert jeden grundlegenden als ganze Dezimalzahl formatierten ganzzahligen Typ, der signiert wird, wenn der grundlegende ganzzahlige Typ signiert wird. |
%u |
Formatiert jeden grundlegenden als ganze Dezimalzahl ohne Vorzeichen formatierten ganzzahligen Typ. |
%x |
Formatiert jeden grundlegenden als ganze Hexadezimalzahl ohne Vorzeichen formatierten ganzzahligen Typ mit Kleinbuchstaben von a bis f. |
%X |
Formatiert jeden grundlegenden als ganze Hexadezimalzahl ohne Vorzeichen formatierten ganzzahligen Typ mit Großbuchstaben von A bis F. |
%o |
Formatiert jeden grundlegenden als ganze Oktalzahl ohne Vorzeichen formatierten ganzzahligen Typ. |
%e, %E, %f, %F, %g, %G |
Formatiert jeden grundlegenden mit einer Gleitkommaformatspezifikation im C-Format formatierten Gleitkommatyp (float, float32). |
%e, %E |
Formatiert einen Wert mit Vorzeichen, der die Form [-]d.dddde[sign]ddd aufweist, wobei d eine einzelne Dezimalstelle ist, dddd eine oder mehrere Dezimalstellen und ddd genau drei Dezimalstellen sind. Die Vorzeichen sind + oder -. |
%f |
Formatiert einen Wert mit Vorzeichen, der die Form [-]dddd.dddd aufweist, wobei dddd eine oder mehrere Dezimalstellen sind. Die Anzahl der Ziffern vor dem Dezimaltrennzeichen ist abhängig von der Größe der Zahl, und die Anzahl der Ziffern nach dem Dezimaltrennzeichen ist abhängig von der angeforderten Genauigkeit. |
%g, %G |
Formatiert einen Wert mit Vorzeichen im f- oder e-Format, je nachdem, was für den angegebenen Wert und die Genauigkeit kompakter ist. |
%M |
Formatiert einen Decimal-Wert. |
%O |
Formatiert jeden Wert, der durch Boxing des Objekts und Verwenden seiner ToString-Methode ausgegeben wurde. |
%A |
Formatiert jeden mit den standardmäßigen Layouteinstellungen ausgegebenen öffentlichen Wert. Das Formular %+A kann verwendet werden, um den Wert nicht öffentlicher Daten zu drucken. Klassen- und Strukturtypen zeigen dasselbe an wie mit %O, unabhängig davon, ob %+A oder %A verwendet wird. |
%a |
Ein allgemeiner Formatbezeichner erfordert zwei Argumente. Das erste Argument ist eine Funktion, die zwei Argumente akzeptiert: Zum Einen einen Kontextparameter des entsprechenden Typs für die angegebene Formatierungsfunktion (z. B. TextWriter), zum Anderen ein auszugebender Wert, der den entsprechenden Text entweder aus- oder zurückgibt. Das zweite Argument ist der bestimmte Ausgabewert. |
%t |
Ein allgemeiner Formatbezeichner, erfordert ein Argument: Eine Funktion, die einen Kontextparameter des entsprechenden Typs für die angegebene Formatierungsfunktion (ein TextWriter-Element) akzeptiert und entsprechenden Text entweder aus- oder zurückgibt. Grundlegende ganzzahlige Typen sind byte, sbyte, int16, uint16, int32, uint32, int64, uint64, nativeint und unativeint. Grundlegende Gleitkommatypen sind float und float32. |
Die optionale Breite ist eine ganze Zahl, die die minimale Breite des Ergebnisses angibt. Mit %6d wird z. B. eine ganze Zahl ausgegeben, der Leerzeichen vorangestellt werden, um mindestens 6 Zeichen auszufüllen. Wenn die Breite * beträgt, wird ein zusätzliches ganzzahliges Argument angenommen, um die entsprechende Breite anzugeben.
Gültige Flags sind in der folgenden Tabelle beschrieben.
0 |
Gibt an, dass Nullen statt Leerzeichen hinzugefügt werden sollen, damit die erforderliche Breite gebildet werden kann. |
- |
Gibt an, dass das Ergebnis innerhalb der angegebenen Breite nach Links ausgerichtet werden soll. |
+ |
Gibt an, dass ein +-Zeichen hinzugefügt werden soll, wenn die Zahl positiv ist (als Entsprechung für ein --Vorzeichen bei negativen Zahlen). Bei der Verwendung mit %A wird angegeben, dass nicht öffentliche Werte ausgegeben werden. |
' ' (Leerzeichen) |
Gibt an, dass zusätzlicher Abstand hinzugefügt werden soll, wenn die Zahl positiv ist (als Entsprechung für ein --Vorzeichen bei negativen Zahlen). |
# |
Ungültig |
Typabkürzungen
Typ |
Beschreibungen |
|---|---|
Stellt ein statisch analysiertes Format für das Schreiben in einen StringBuilder dar. Der erste Typparameter gibt die Argumente der Formatierungsoperation und der letzte den Gesamtrückgabetyp an. |
|
Stellt ein statisch analysiertes Format für das Schreiben in einen StringBuilder dar. Der Typparameter gibt die Argumente und den Rückgabetyp der Formatierungsoperation an. |
|
Stellt ein statisch analysiertes Format dar, wenn bei der Formatierung eine Zeichenfolge erstellt wird. Der erste Typparameter gibt die Argumente der Formatierungsoperation und der letzte den Gesamtrückgabetyp an. |
|
Typ StringFormat<'T> |
Stellt ein statisch analysiertes Format dar, wenn bei der Formatierung eine Zeichenfolge erstellt wird. Der Typparameter gibt die Argumente und den Rückgabetyp der Formatierungsoperation an. |
Stellt ein statisch analysiertes Format für das Schreiben in einen TextWriter dar. Der erste Typparameter gibt die Argumente der Formatierungsoperation und der letzte den Gesamtrückgabetyp an. |
|
Stellt ein statisch analysiertes Format für das Schreiben in einen TextWriter dar. Der Typparameter gibt die Argumente und den Rückgabetyp der Formatierungsoperation an. |
Werte
Value |
Beschreibungen |
|---|---|
bprintf : StringBuilder -> BuilderFormat<'T> -> 'T |
Druckt in StringBuilder. |
eprintf : TextWriterFormat<'T> -> 'T |
Druckt die formatierte Ausgabe in stderr. |
eprintfn : TextWriterFormat<'T> -> 'T |
Druckt die formatierte Ausgabe in stderr und fügt einen Zeilenvorschub hinzu. |
failwithf : StringFormat<'T,'Result> -> 'T |
Druckt in einen Zeichenfolgenpuffer und löst eine Ausnahme mit dem angegebenen Ergebnis aus. Hilfsdrucker müssen Zeichenfolgen zurückgeben. |
fprintf : TextWriter -> TextWriterFormat<'T> -> 'T |
Ausgabe mit einem Textwriter. |
fprintfn : TextWriter -> TextWriterFormat<'T> -> 'T |
Ausgabe mit einem TextWriter mit Hinzufügen eines Zeilenvorschubs |
kbprintf : (unit -> 'Result) -> StringBuilder -> BuilderFormat<'T,'Result> -> 'T |
Wie bprintf, ruft jedoch die angegebene Funktion zum Generieren des Ergebnisses auf. Weitere Informationen finden Sie unter kprintf. |
kfprintf : (unit -> 'Result) -> TextWriter -> TextWriterFormat<'T,'Result> -> 'T |
Wie fprintf, ruft jedoch die angegebene Funktion zum Generieren des Ergebnisses auf. Weitere Informationen finden Sie unter kprintf. |
kprintf : (string -> 'Result) -> StringFormat<'T,'Result> -> 'T |
Wie printf, ruft jedoch die angegebene Funktion zum Generieren des Ergebnisses auf. Hiermit kann bei der Ausgabe z. B. ein Leeren erzwungen werden, nachdem alle Ausgaben in den Channel eingegeben wurden, jedoch nicht vorher. |
ksprintf : (string -> 'Result) -> StringFormat<'T,'Result> -> 'T |
Wie sprintf, ruft jedoch die angegebene Funktion zum Generieren des Ergebnisses auf. Weitere Informationen finden Sie unter kprintf. |
printf : TextWriterFormat<'T> -> 'T |
Druckt die formatierte Ausgabe in stdout. |
printfn : TextWriterFormat<'T> -> 'T |
Druckt die formatierte Ausgabe in stdout und fügt einen Zeilenvorschub hinzu. |
sprintf : StringFormat<'T> -> 'T |
Druckt in eine Zeichenfolge mithilfe eines internen Zeichenfolgenpuffers, und gibt das Ergebnis als Zeichenfolge zurück. Hilfsdrucker müssen Zeichenfolgen zurückgeben. |
Plattformen
Windows 7, Windows Vista SP2, Windows XP SP3, Windows XP x64 SP2, Windows Server 2008 R2, Windows Server 2008 SP2, Windows Server 2003 SP2
Versionsinformationen
F#-Runtime
Unterstützt in: 2.0, 4.0
Silverlight
Unterstützt in: 2, 3
Siehe auch
Weitere Ressourcen
Microsoft.FSharp.Core-Namespace (F#)
Änderungsprotokoll
Datum |
Versionsgeschichte |
Grund |
|---|---|---|
|
April 2011 |
Informationen über %+A hinzugefügt. |
Kundenfeedback. |