Copyright	(c) Dong Han 2017-2019
License	BSD
Maintainer	winterland1989@gmail.com
Stability	experimental
Portability	non-portable
Safe Haskell	None
Language	Haskell2010

Std.Data.Builder.Numeric

Contents

Integral type formatting
Fixded size hexidecimal formatting
IEEE float formating
Misc

Description

Textual numeric builders.

Synopsis

data IFormat = IFormat {
- width :: Int
- padding :: Padding
- postiveSign :: Bool
}
defaultIFormat :: IFormat
data Padding
- = NoPadding
- | ZeroPadding
- | LeftSpacePadding
- | RightSpacePadding
int :: (Integral a, Bounded a) => a -> Builder ()
intWith :: (Integral a, Bounded a) => IFormat -> a -> Builder ()
integer :: Integer -> Builder ()
hex :: forall a. (FiniteBits a, Integral a) => a -> Builder ()
heX :: forall a. (FiniteBits a, Integral a) => a -> Builder ()
data FFormat
- = Exponent
- | Fixed
- | Generic
double :: Double -> Builder ()
doubleWith :: FFormat -> Maybe Int -> Double -> Builder ()
float :: Float -> Builder ()
floatWith :: FFormat -> Maybe Int -> Float -> Builder ()
scientific :: Scientific -> Builder ()
scientificWith :: FFormat -> Maybe Int -> Scientific -> Builder ()
grisu3 :: Double -> Maybe ([Int], Int)
grisu3_sp :: Float -> Maybe ([Int], Int)
i2wDec :: Integral a => a -> Word8
i2wHex :: Integral a => a -> Word8
i2wHeX :: Integral a => a -> Word8
countDigits :: Integral a => a -> Int

Integral type formatting

data IFormat Source #

Integral formatting options.

Constructors

IFormat
Fields width :: Int total width, only effective with padding options padding :: Padding padding options postiveSign :: Bool show `+` when the number is positive

Instances

Eq IFormat Source #
Instance details Defined in Std.Data.Builder.Numeric Methods (==) :: IFormat -> IFormat -> Bool # (/=) :: IFormat -> IFormat -> Bool #
Ord IFormat Source #
Instance details Defined in Std.Data.Builder.Numeric Methods compare :: IFormat -> IFormat -> Ordering # (<) :: IFormat -> IFormat -> Bool # (<=) :: IFormat -> IFormat -> Bool # (>) :: IFormat -> IFormat -> Bool # (>=) :: IFormat -> IFormat -> Bool # max :: IFormat -> IFormat -> IFormat # min :: IFormat -> IFormat -> IFormat #
Show IFormat Source #
Instance details Defined in Std.Data.Builder.Numeric Methods showsPrec :: Int -> IFormat -> ShowS # show :: IFormat -> String # showList :: [IFormat] -> ShowS #

defaultIFormat :: IFormat Source #

defaultIFormat = IFormat 0 NoPadding False Decimal

data Padding Source #

Constructors

NoPadding
ZeroPadding
LeftSpacePadding
RightSpacePadding

Instances

Eq Padding Source #
Instance details Defined in Std.Data.Builder.Numeric Methods (==) :: Padding -> Padding -> Bool # (/=) :: Padding -> Padding -> Bool #
Ord Padding Source #
Instance details Defined in Std.Data.Builder.Numeric Methods compare :: Padding -> Padding -> Ordering # (<) :: Padding -> Padding -> Bool # (<=) :: Padding -> Padding -> Bool # (>) :: Padding -> Padding -> Bool # (>=) :: Padding -> Padding -> Bool # max :: Padding -> Padding -> Padding # min :: Padding -> Padding -> Padding #
Show Padding Source #
Instance details Defined in Std.Data.Builder.Numeric Methods showsPrec :: Int -> Padding -> ShowS # show :: Padding -> String # showList :: [Padding] -> ShowS #

int :: (Integral a, Bounded a) => a -> Builder () Source #

int = intWith defaultIFormat

intWith :: (Integral a, Bounded a) => IFormat -> a -> Builder () Source #

Format a Bounded Integral type like Int or Word16 into decimal ASCII digits.

integer :: Integer -> Builder () Source #

Format a Integer into decimal ASCII digits.

Fixded size hexidecimal formatting

hex :: forall a. (FiniteBits a, Integral a) => a -> Builder () Source #

Format a FiniteBits Integral type into hex nibbles.

heX :: forall a. (FiniteBits a, Integral a) => a -> Builder () Source #

The UPPERCASED version of hex.

IEEE float formating

data FFormat Source #

Control the rendering of floating point numbers.

Constructors

Exponent	Scientific notation (e.g. `2.3e123`).
Fixed	Standard decimal notation.
Generic	Use decimal notation for values between `0.1` and `9,999,999`, and scientific notation otherwise.

Instances

Enum FFormat Source #
Instance details Defined in Std.Data.Builder.Numeric Methods succ :: FFormat -> FFormat # pred :: FFormat -> FFormat # toEnum :: Int -> FFormat # fromEnum :: FFormat -> Int # enumFrom :: FFormat -> [FFormat] # enumFromThen :: FFormat -> FFormat -> [FFormat] # enumFromTo :: FFormat -> FFormat -> [FFormat] # enumFromThenTo :: FFormat -> FFormat -> FFormat -> [FFormat] #
Read FFormat Source #
Instance details Defined in Std.Data.Builder.Numeric Methods readsPrec :: Int -> ReadS FFormat # readList :: ReadS [FFormat] # readPrec :: ReadPrec FFormat # readListPrec :: ReadPrec [FFormat] #
Show FFormat Source #
Instance details Defined in Std.Data.Builder.Numeric Methods showsPrec :: Int -> FFormat -> ShowS # show :: FFormat -> String # showList :: [FFormat] -> ShowS #

double :: Double -> Builder () Source #

Decimal encoding of an IEEE Double.

Using standard decimal notation for arguments whose absolute value lies between 0.1 and 9,999,999, and scientific notation otherwise.

doubleWith Source #

Arguments

:: FFormat
-> Maybe Int	Number of decimal places to render.
-> Double
-> Builder ()

Format double-precision float using drisu3 with dragon4 fallback.

float :: Float -> Builder () Source #

Decimal encoding of an IEEE Float.

Using standard decimal notation for arguments whose absolute value lies between 0.1 and 9,999,999, and scientific notation otherwise.

floatWith Source #

Arguments

:: FFormat
-> Maybe Int	Number of decimal places to render.
-> Float
-> Builder ()

Format single-precision float using drisu3 with dragon4 fallback.

scientific :: Scientific -> Builder () Source #

A Builder which renders a scientific number to full precision, using standard decimal notation for arguments whose absolute value lies between 0.1 and 9,999,999, and scientific notation otherwise.

scientificWith Source #

Arguments

:: FFormat
-> Maybe Int	Number of decimal places to render.
-> Scientific
-> Builder ()

Like scientific but provides rendering options.

Misc

grisu3 :: Double -> Maybe ([Int], Int) Source #

Decimal encoding of a Double.

grisu3_sp :: Float -> Maybe ([Int], Int) Source #

Decimal encoding of a Float.

i2wDec :: Integral a => a -> Word8 Source #

Decimal digit to ASCII digit.

i2wHex :: Integral a => a -> Word8 Source #

Hexadecimal digit to ASCII char.

i2wHeX :: Integral a => a -> Word8 Source #

Hexadecimal digit to UPPERCASED ASCII char.

countDigits :: Integral a => a -> Int Source #

Count how many decimal digits an integer has.