| Haskell Hierarchical Libraries (base package) | Source code | Contents | Index

Text.Printf

Portability | portable
Stability | provisional
Maintainer | lennart@augustsson.net

Description
A C printf like formatter.
Synopsis

printf :: PrintfType r => String -> r
hPrintf :: HPrintfType r => Handle -> String -> r
class PrintfType t
class HPrintfType t
class PrintfArg a
class IsChar c

Documentation
printf :: PrintfType r => String -> r

Format a variable number of arguments with the C-style formatting string. The return value is either `String` or `(`IO` a)`.

The format string consists of ordinary characters and conversion specifications, which specify how to format one of the arguments to printf in the output string. A conversion specification begins with the character `%`, followed by one or more of the following flags:

        -      left adjust (default is right adjust)
        0      pad with zeroes rather than spaces

followed optionally by a field width:

        num    field width
        *      as num, but taken from argument list

followed optionally by a precision:

        .num   precision (number of decimal places)

and finally, a format character:

        c      character               Char, Int, Integer
        d      decimal                 Char, Int, Integer
        o      octal                   Char, Int, Integer
        x      hexadecimal             Char, Int, Integer
        u      unsigned decimal        Char, Int, Integer
        f      floating point          Float, Double
        g      general format float    Float, Double
        e      exponent format float   Float, Double
        s      string                  String

Mismatch between the argument types and the format string will cause an exception to be thrown at runtime.

Examples:

       > printf "%d\n" (23::Int)
       23
       > printf "%s %s\n" "Hello" "World"
       Hello World
       > printf "%.2f\n" pi
       3.14

hPrintf :: HPrintfType r => Handle -> String -> r
Similar to `printf`, except that output is via the specified `Handle`. The return type is restricted to `(`IO` a)`.
class PrintfType t

The `PrintfType` class provides the variable argument magic for `printf`. Its implementation is intentionally not visible from this module. If you attempt to pass an argument of a type which is not an instance of this class to `printf` or `hPrintf`, then the compiler will report it as a missing instance of `PrintfArg`.
Instances

(PrintfArg a, PrintfType r) => PrintfType (a -> r)
PrintfType (IO a)
IsChar c => PrintfType [c]

class HPrintfType t

The `HPrintfType` class provides the variable argument magic for `hPrintf`. Its implementation is intentionally not visible from this module.
Instances

(PrintfArg a, HPrintfType r) => HPrintfType (a -> r)
HPrintfType (IO a)

class PrintfArg a

Instances

PrintfArg Char
PrintfArg Double
PrintfArg Float
PrintfArg Int
PrintfArg Integer
IsChar c => PrintfArg [c]

class IsChar c

Instances

IsChar Char

Produced by Haddock version 0.8