Udostępnij za pośrednictwem

Core.Printf — Moduł (F#)

  • Artykuł

Rozszerzenie printf-styl formatowania dla liczb i innych typów danych.

Przestrzeń nazw/Ścieżka modułu: Microsoft.FSharp.Core

Zestaw: FSharp.Core (w FSharp.Core.dll)

module Printf

Uwagi

Specyfikacją formatu są ciągi z znacznikiem % wskazującym format symboli zastępczych.Format symboli zastępczych składa się z: %[flags][width][.precision][type] gdzie typ jest interpretowany jak w poniższej tabeli:

Typ

Opis

%b

Formaty bool, sformatowane jako true lub false.

%c

Formaty znaku.

%s

Formaty string, sformatowany jako jego zawartość, bez interpretacji żadnych znaków ucieczki.

%d, %i

Formaty dowolnego podstawowego typu całkowitego sformatowane jako całkowita liczba dziesiętna ze znakiem jeżeli podstawowy typ całkowity jest ze znakiem.

%u

Formaty dowolnego podstawowego typu całkowitego sformatowane jako całkowita liczba dziesiętna bez znaku.

%x

Formaty dowolnego podstawowego typu całkowitego sformatowane jako szesnastkowa liczba całkowita bez znaku, przy użyciu małych liter od a do f.

%X

Formaty dowolnego podstawowego typu całkowitego sformatowane jako szesnastkowa liczba całkowita bez znaku, przy użyciu wielkich liter od A do F.

%o

Formaty dowolnego podstawowego typu całkowitego sformatowane jako całkowita liczba bez znaku w postaci ósemkowej.

%e, %E, %f, %F, %g, %G

Formaty dowolnych podstawowych typów liczb zmiennoprzecinkowych (float, float32) sformatowane przy użyciu specyfikacji formatu liczb zmiennoprzecinkowych w stylu języka C.

%e, %E

Formatuje wartości ze znakiem w postaci [-]d.dddde[sign]ddd gdzie d jest pojedynczą cyfrą dziesiętna, dddd reprezentuje jedną lub więcej cyfr dziesiętnych, ddd reprezentuje dokładnie trzy cyfry dziesiętne, i znak + lub -.

%f

Formatuje wartości ze znakiem w postaci [-]dddd.dddd, gdzie dddd reprezentuje jedną lub więcej cyfr dziesiętnych.Liczba cyfr przed przecinkiem dziesiętnym zależy od wartości liczby, natomiast liczba cyfr po przecinku dziesiętnym zależy od żądanej dokładności.

%g, %G

Formaty wartości ze znakiem drukowanych w formacie e lub f, w zależności od tego, który jest bardziej kompaktowy dla danej wartości i precyzji.

%M

Formaty wartości Decimal.

%O

Formaty dowolnych wartości, drukowanych za pomocą konwersji boxing obiektu oraz przy użyciu jego metody ToString.

%A, %+A

Formaty dowolnych wartości, drukowane z domyślnymi ustawieniami układu.Należy użyć %+A do drukowania struktur sum rozłącznych z wewnętrzną i prywatną reprezentacją.

%a

Generalny specyfikator formatu wymaga dwóch argumentów.Pierwszy argument jest funkcją, która przyjmuje dwa argumenty: pierwszy, parametr kontekstowy odpowiedniego typu dla danej funkcji formatowania (na przykład TextWriter), drugi parametr to wartość do drukowania informacji wyjściowych lub zwracania odpowiedniego tekstu.

Drugi argument jest określona wartością do wydrukowania.

%t

Generalny specyfikator formatu wymaga jednego argumentu: funkcji, która przyjmuje parametr kontekstowy odpowiedniego typu dla danej funkcji formatowania (TextWriter), która albo wychodzi albo zwraca odpowiedni tekst.Podstawowymi typami całkowitymi są byte, sbyte, int16, uint16, int32, uint32, int64, uint64, nativeint, i unativeint.Podstawowymi typami liczb zmiennoprzecinkowych są float i float32.

Opcjonalny width jest liczbą całkowitą reprezentującą minimalną szerokość wyniku.Na przykład, %6d drukuje liczbę całkowitą poprzedzając ją spacjami, aby wypełnić co najmniej 6 znaków.Jeżeli szerokością jest *, dodatkowy argument w postaci liczby całkowitej jest wykorzystany, aby określić odpowiadającą szerokość.

Prawidłowe flagi są opisane w poniższej tabeli.

0

Określa dodanie zer zamiast spacji, aby uzupełnić wymaganą szerokość.

-

Określa wyjustowanie wyniku do lewej strony w określonej szerokości.

+

Określa dodanie znaku + , jeśli liczba jest dodatnia (aby dopasować znak - dla liczb ujemnych).

' ' (odstęp)

Określa dodanie dodatkowego znaku spacji jeśli liczba jest dodatnia (aby dopasować znak - dla liczb ujemnych).

#

Nieprawidłowy.

Skróty typów

Typ

Opis

typ BuilderFormat<'T,'Result>

Reprezentuje format statycznie analizowany skojarzony z zapisem do StringBuilder.Pierwszy typ parametru wskazuje argumenty operacji formatowania i ostatni ogólny typ zwracany.

typ BuilderFormat<'T>

Reprezentuje format statycznie analizowany skojarzony z zapisem do StringBuilder.Typ parametru wskazuje argumenty i zwracany typ operacji formatowania.

typ StringFormat<'T,'Result>

Reprezentuje format statycznie analizowany podczas formatowania kompilowanego ciągu.Pierwszy typ parametru wskazuje argumenty operacji formatowania i ostatni ogólny typ zwracany.

typ StringFormat<'T>

Reprezentuje format statycznie analizowany podczas formatowania kompilowanego ciągu.Typ parametru wskazuje argumenty i zwracany typ operacji formatowania.

typ TextWriterFormat<'T,'Result>

Reprezentuje format statycznie analizowany skojarzony z zapisem do TextWriter.Pierwszy typ parametru wskazuje argumenty operacji formatowania i ostatni ogólny typ zwracany.

typ TextWriterFormat<'T>

Reprezentuje format statycznie analizowany skojarzony z zapisem do TextWriter.Typ parametru wskazuje argumenty i zwracany typ operacji formatowania.

Wartości

Wartość

Opis

bprintf : StringBuilder -> BuilderFormat<'T> -> 'T

Drukuje do StringBuilder.

eprintf : TextWriterFormat<'T> -> 'T

Drukuje sformatowane dane wyjściowe do stderr.

eprintfn : TextWriterFormat<'T> -> 'T

Drukuje sformatowane dane wyjściowe do stderr, dodaje nowy wiersz.

failwithf : StringFormat<'T,'Result> -> 'T

Drukuje do buforu ciągu oraz zgłasza wyjątek w związku z danym wynikiem.Drukarki pomocników muszą zwracać ciągi.

fprintf: TextWriter -> TextWriterFormat<'T> -> 'T

Drukuje do składnika zapisywania tekstu.

fprintfn : TextWriter -> TextWriterFormat<'T> -> 'T

Drukowanie do składnika zapisywania tekstu, dodanie nowego wiersza.

kbprintf : (unit -> 'Result) -> StringBuilder -> BuilderFormat<'T,'Result> -> 'T

Jak bprintf, ale wywołuje określoną funkcję, aby wygenerować rezultat.Zobacz kprintf.

kfprintf : (unit -> 'Result) -> TextWriter -> TextWriterFormat<'T,'Result> -> 'T

Jak fprintf, ale wywołuje określoną funkcję, aby wygenerować rezultat.Zobacz kprintf.

kprintf : (string -> 'Result) -> StringFormat<'T,'Result> -> 'T

Jak printf, ale wywołuje określoną funkcję, aby wygenerować rezultat.Na przykład, pozwalają na wymuszony wydruk opróżniania po wprowadzeniu wszystkich danych wyjściowych do kanału, lecz nie wcześniej.

ksprintf : (string -> 'Result) -> StringFormat<'T,'Result> -> 'T

Jak sprintf, ale wywołuje określoną funkcję, aby wygenerować rezultat.Zobacz kprintf.

drukuj : TextWriterFormat<'T> -> 'T

Drukuje sformatowane dane wyjściowe do stdout.

drukuj : TextWriterFormat<'T> -> 'T

Drukuje sformatowane dane wyjściowe do stdout, dodaje nowy wiersz.

sprintf : StringFormat<'T> -> 'T

Drukuje do ciągu przy użyciu wewnętrznego buforu i zwraca wynik w postaci ciągu.Drukarki pomocników muszą zwracać ciągi.

Platformy

Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2

Informacje o wersji

Wersje podstawowe biblioteki języka F#

Obsługiwane przez: 2.0, 4.0, przenośne

Obsługiwane w: 2, 3

Zobacz też

Informacje

Microsoft.FSharp.Core — Przestrzeń nazw (F#)