Core.Printf – modul (F#)
Rozšiřitelné formátování čísel a jiných datových typů stylem printf.
Obor názvů/cesta modulu: Microsoft.FSharp.Core
Sestavení: FSharp.Core (v FSharp.Core.dll)
module Printf
Poznámky
Specifikace formátu jsou řetězce se značkami % označujícími zástupné symboly formátu.Zástupné symboly formátu se skládají z: %[flags][width][.precision][type], kde typ je interpretován dle následující tabulky:
Type |
Description |
|---|---|
%b |
Formátuje bool jako true nebo false. |
%c |
Formátuje znak. |
%s |
Formátuje string jako jeho obsah bez interpretace řídících znaků. |
%d, %i |
Formátuje jakýkoli základní celočíselný typy jako celé desítkové číslo, se znaménkem, pokud je základní celočíselný typ se znaménkem. |
%u |
Formátuje libovolný základní celočíselný typ jako desítkové číslo bez znaménka. |
%x |
Formátuje libovolný základní celočíselný typ jako šestnáctkové číslo bez znaménka použitím malých písmen a až f. |
%X |
Formátuje libovolný základní celočíselný typ jako šestnáctkové číslo bez znaménka použitím velkých písmen A až F. |
%o |
Formátuje libovolný základní celočíselný typ jako osmičkové číslo bez znaménka. |
%e, %E, %f, %F, %g, %G |
Formátuje libovolný základní číselný typ s plovoucí desetinnou čárkou (float, float32) pomocí specifikace stylu formátu jazyka C pro čísla s plovoucí desetinnou čárkou. |
%e, %E |
Formátuje hodnotu se znaménkem ve formátu [-]d.dddde[sign]ddd, kde d je jedna desítková číslice, dddd je jedna nebo více desítkových číslic a ddd jsou přesně tři desítkové číslice a znak + nebo -. |
%f |
Formátuje hodnotu se znaménkem ve formátu [-]dddd.dddd, kde dddd je jedna nebo více desítkových číslic.Počet číslic před desetinnou čárkou závisí na velikosti čísla a počet číslic za desetinnou čárkou závisí na požadované přesnosti. |
%g, %G |
Formátuje hodnotu se znaménkem vytištěnu ve formátu f nebo e, podle toho, co je pro danou hodnotu a přesnost kompaktnější. |
%M |
Formátuje hodnotu Decimal. |
%O |
Formátuje libovolnou hodnotu vytištěnou zabalením objektu a použitím jeho metody ToString. |
%A, %+A |
Formátuje libovolnou hodnotu vytištěnou výchozím nastavením rozložení.Pro tisk struktury rozlišujících sjednocení se zastoupením internal a private je třeba použít %+A. |
%a |
Obecný specifikátor formátu vyžaduje dva argumenty.První argument je funkce, která přijímá dva argumenty: první, parametr kontextu příslušného typu pro danou funkci formátování (například TextWriter), a druhý, hodnotu pro tisk, která vypíše nebo vrátí odpovídající text. Druhý argument je hodnota k tisku. |
%t |
Obecný specifikátor formátu vyžaduje jeden argument: funkci, která přijímá parametr kontextu vhodného typu pro danou funkci formátování (TextWriter) a která buď vypisuje nebo vrací odpovídající text.Základní celočíselné typy jsou byte, sbyte, int16, uint16, int32, uint32, int64, uint64, nativeint a unativeint.Číselné typy s plovoucí desetinnou čárkou jsou float a float32. |
Nepovinný parametr width je celé číslo označující minimální šířku výsledku.Například %6d vytiskne celé číslo jemuž předcházejí mezery pro vyplnění nejméně 6 znaků.Pokud je šířka *, pak se celočíselný argument bere pro určení odpovídající šířky.
Platné příznaky jsou popsány v následující tabulce.
0 |
Určuje, že je třeba přidat nuly namísto mezer, a tím vytvořit požadovanou šířku. |
- |
Určuje zarovnání výsledku vlevo v zadané šířce. |
+ |
Určuje přidání znaku +, pokud je číslo kladné (tak, aby odpovídal znaku - pro záporná čísla). |
' ' (mezera) |
Určuje přidání dodatečné mezery, pokud je číslo kladné (tak, aby odpovídala znaku - pro záporná čísla). |
# |
Neplatný. |
Zkratky typů
Type |
Description |
|---|---|
Představuje staticky analyzovaný formát přidružený k zápisu do objektu StringBuilder.První parametr typu označuje argumenty operace formátování a poslední celkový návratový typ. |
|
Představuje staticky analyzovaný formát přidružený k zápisu do objektu StringBuilder.Parametr typu určuje argumenty a návratový typ operace formátování. |
|
Představuje staticky analyzovaný formát pokud formátování vytváří řetězec.První parametr typu označuje argumenty operace formátování a poslední celkový návratový typ. |
|
typ StringFormat<'T> |
Představuje staticky analyzovaný formát pokud formátování vytváří řetězec.Parametr typu určuje argumenty a návratový typ operace formátování. |
Představuje staticky analyzovaný formát přidružený k zápisu do objektu TextWriter.První parametr typu označuje argumenty operace formátování a poslední celkový návratový typ. |
|
Představuje staticky analyzovaný formát přidružený k zápisu do objektu TextWriter.Parametr typu určuje argumenty a návratový typ operace formátování. |
Hodnoty
Value |
Description |
|---|---|
bprintf : StringBuilder -> BuilderFormat<'T> -> 'T |
Tiskne do StringBuilder. |
eprintf : TextWriterFormat<'T> -> 'T |
Tiskne formátovaný výstup do stderr. |
eprintfn : TextWriterFormat<'T> -> 'T |
Tiskne formátovaný výstup do stderr a přidává nový řádek. |
failwithf : StringFormat<'T,'Result> -> 'T |
Tiskne do vyrovnávací paměti řetězce a vyvolává výjimku s daným výsledkem.Pomocné tiskárny musí vracet řetězce. |
fprintf: TextWriter -> TextWriterFormat<'T> -> 'T |
Tiskne do zapisovače textu. |
fprintfn : TextWriter -> TextWriterFormat<'T> -> 'T |
Tiskne do zapisovače textu a přidává nový řádek. |
kbprintf : (unit -> 'Result) -> StringBuilder -> BuilderFormat<'T,'Result> -> 'T |
Jako bprintf, ale pro generování výsledku volá určenou funkci.Viz kprintf. |
kfprintf : (unit -> 'Result) -> TextWriter -> TextWriterFormat<'T,'Result> -> 'T |
Jako fprintf, ale pro generování výsledku volá určenou funkci.Viz kprintf. |
kprintf : (string -> 'Result) -> StringFormat<'T,'Result> -> 'T |
Jako printf, ale pro generování výsledku volá určenou funkci.Toto například vynutí vyprázdnění poté, co byl veškerý výstup vložen do kanálu, ale ne dříve. |
ksprintf : (string -> 'Result) -> StringFormat<'T,'Result> -> 'T |
Jako sprintf, ale pro generování výsledku volá určenou funkci.Viz kprintf. |
printf : TextWriterFormat<'T> -> 'T |
Tiskne formátovaný výstup do stdout. |
printfn : TextWriterFormat<'T> -> 'T |
Tiskne formátovaný výstup do stdout a přidává nový řádek. |
sprintf : StringFormat<'T> -> 'T |
Tiskne do řetězce pomocí vnitřní vyrovnávací paměti řetězce a vrátí výsledek jako řetězec.Pomocné tiskárny musí vracet řetězce. |
Platformy
Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2
Informace o verzi
Verze základní knihovny F#
Podporováno ve verzích: 2.0, 4.0, Portable
Podporováno v: 2, 3