bytestring-show-0.1: Efficient conversion of values into readable byte strings. Source code Contents Index

Text.Show.ByteString Portability Non-portable (type synonym instances) Stability Experimental Maintainer Dan Doel

Contents The Show class Putting Chars Putting Strings Putting digits Putting floats Combining builders Printing values

Description

Efficiently convert from values to lazy byte strings.

Synopsis

class Show a where showp :: a -> Put showpList :: [a] -> Put show :: Show a => a -> ByteString putAscii :: Char -> Put putUTF8 :: Char -> Put putAsciiStr :: String -> Put putUTF8Str :: String -> Put unsafePutDigit :: Int -> Put putDigit :: Int -> Put showpGFloat :: RealFloat a => Maybe Int -> a -> Put showpFFloat :: RealFloat a => Maybe Int -> a -> Put showpEFloat :: RealFloat a => Maybe Int -> a -> Put unlinesP :: [Put] -> Put unwordsP :: [Put] -> Put print :: Show a => a -> IO ()

The Show class

class Show a where Source

Conversion of values to readable byte strings. Minimal complete definition: showp Methods showp :: a -> Put Source Encodes a value to an efficient byte string builder. Values of type Put can be efficiently combined, so this is available for building strings from multiple values. showpList :: [a] -> Put Source Allows for specialized display of lists of values. This is used, for example, when showing arrays of Chars. Instances Show Bool Show Char Show Double Show Float Show Int Show Int8 Show Int16 Show Int32 Show Integer Show Word Show Word8 Show Word16 Show Word32 Show () Show Put Show a => Show ([] a) (Show a, Integral a) => Show (Ratio a) (Show a, RealFloat a) => Show (Complex a) Show a => Show (Maybe a) (Show a, Show b) => Show ((,) a b) (Show a, Show b, Show c) => Show ((,,) a b c) (Show a, Show b, Show c, Show d) => Show ((,,,) a b c d) (Show a, Show b, Show c, Show d, Show e) => Show ((,,,,) a b c d e) (Show a, Show b, Show c, Show d, Show e, Show f) => Show ((,,,,,) a b c d e f) (Show a, Show b, Show c, Show d, Show e, Show f, Show g) => Show ((,,,,,,) a b c d e f g)

show :: Show a => a -> ByteString Source

Encode a single value into a byte string

Putting Chars

putAscii :: Char -> Put Source

Writes a single Char to a byte string, assuming it's ascii.

putUTF8 :: Char -> Put Source

Writes a single Char to a byte string, properly UTF-8 encoded

Putting Strings

putAsciiStr :: String -> Put Source

Writes a string of ascii characters to a byte string

putUTF8Str :: String -> Put Source

Writes a string of unicode characters to a byte string, properly UTF-8 encoded

Putting digits

unsafePutDigit :: Int -> Put Source

Puts the decimal digit corresponding to the given Int without checking that it is in the interval [0,9]

putDigit :: Int -> Put Source

Puts the digit corresponding to the Int passed in.

Putting floats

showpGFloat :: RealFloat a => Maybe Int -> a -> Put Source

Show a signed RealFloat value using decimal notation when the absolute value lies between 0.1 and 9,999,999, and scientific notation otherwise. The optional integer can be used to specify precision.

showpFFloat :: RealFloat a => Maybe Int -> a -> Put Source

Show a signed RealFloat value using decimal notation. The optional integer can be used to specify precision.

showpEFloat :: RealFloat a => Maybe Int -> a -> Put Source

Show a signed RealFloat value using scientific (exponential) notation. The optional integer can be used to specify precision.

Combining builders

unlinesP :: [Put] -> Put Source

Merge several string builders, separating them by newlines

unwordsP :: [Put] -> Put Source

Merge several string builders, separating them by spaces

Printing values

print :: Show a => a -> IO () Source

Print a value to the standard output

Produced by Haddock version 2.3.0