Formatting.Formatters

Output a lazy text.

Output a strict text.

Output a string.

Output a showable value (instance of Show) by turning it into Text:

>>> format ("Value number " % shown % " is " % shown % ".") 42 False"Value number 42 is False."

Output a character.

Build a builder.

Like const but for formatters.

Render an integral e.g. 123 -> "123", 0 -> "0".

Render some floating point with the usual notation, e.g. 123.32 => "123.32"

Render a floating point number using normal notation, with the given number of decimal places.

Render a scientific number.

Render a scientific number with options.

Render a floating point number using the smallest number of digits that correctly represent it. Note that in the case of whole numbers it will still add one decimal place, e.g. "1.0".

Group integral numbers, e.g. groupInt 2 . on 123456 -> "12.34.56".

Add commas to an integral, e.g 12000 -> "12,000".

Add a suffix to an integral, e.g. 1st, 2nd, 3rd, 21st.

English plural suffix for an integral.

For example:

>>> :set -XOverloadedStrings>>> formatPeople = format (int % " " <> plural "person" "people" % ".") :: Int -> Data.Text.Lazy.Text>>> formatPeople 1"1 person.">>> formatPeople 3"3 people."

Shows the Int value of Enum instances using fromEnum.

>>> format ("Got: " % char % " (" % asInt % ")") 'a' 'a'"Got: a (97)"

Pad the left hand side of a string until it reaches k characters wide, if necessary filling with character c.

Pad the right hand side of a string until it reaches k characters wide, if necessary filling with character c.

Pad the left & right hand side of a string until it reaches k characters wide, if necessary filling with character c.

Fit in the given length, truncating on the left.

Fit in the given length, truncating on the right.

Render an integral at base n.

Render an integer using binary notation. (No leading 0b is added.) Defined as bin = base 2.

Render an integer using octal notation. (No leading 0o is added.) Defined as oct = base 8.

Render an integer using hexadecimal notation. (No leading 0x is added.) Has a specialized implementation.

Render an integer using binary notation with a leading 0b.

See also binPrefix for fixed-width formatting.

Render an integer using octal notation with a leading 0o.

See also octPrefix for fixed-width formatting.

Render an integer using hexadecimal notation with a leading 0x.

See also hexPrefix for fixed-width formatting.

Renders a given byte count using an appropiate decimal binary suffix:

>>> format (bytes shortest) 1024"1KB"

>>> format (bytes (fixed 2 % " ")) (1024*1024*5)"5.00 MB"

Build anything that implements the Buildable class.

The class of types that can be rendered to a Builder.