Data.Double.Conversion.Convertable

Documentation

class (RealFloat a, IsString b) => Convertable a b where

Type class for floating data types, that can be converted, using double-conversion library

Default instanced convert input to Double and then make Bytestring Builder from it.

list of functions :

toExponential: Compute a representation in exponential format with the requested number of digits after the decimal point. The last emitted digit is rounded. If -1 digits are requested, then the shortest exponential representation is computed.

toPrecision: Compute precision leading digits of the given value either in exponential or decimal format. The last computed digit is rounded.

toFixed: Compute a decimal representation with a fixed number of digits after the decimal point. The last emitted digit is rounded.

toShortest: Compute the shortest string of digits that correctly represent the input number.

Conversion to text via Builder (both in the in case of bytestring and text) in case of single number is a bit slower, than to text or bytestring directly. But conversion a large amount of numbers to text via Builder (for example using foldr) is much faster than direct conversion to Text (up to 10-15x).

The same works for bytestrings: conversion, for example, a list of 20000 doubles to bytestring builder and then to bytestring is about 13 times faster than direct conversion of this list to bytestring.

Conversion to text via text builder is a little bit slower, than conversion to bytestring via bytestring builder.

Minimal complete definition

Nothing

Methods

toExponential :: Int -> a -> b

default toExponential :: b ~ Builder => Int -> a -> b

toPrecision :: Int -> a -> b

default toPrecision :: b ~ Builder => Int -> a -> b

toFixed :: Int -> a -> b

default toFixed :: b ~ Builder => Int -> a -> b

toShortest :: a -> b

default toShortest :: b ~ Builder => a -> b

Instances

Convertable Double Builder

Defined in Data.Double.Conversion.Convertable

Methods

toExponential :: Int -> Double -> Builder

toPrecision :: Int -> Double -> Builder

toFixed :: Int -> Double -> Builder

toShortest :: Double -> Builder

Convertable Double ByteString

Defined in Data.Double.Conversion.Convertable

Methods

toExponential :: Int -> Double -> ByteString

toPrecision :: Int -> Double -> ByteString

toFixed :: Int -> Double -> ByteString

toShortest :: Double -> ByteString

Convertable Double Text

Defined in Data.Double.Conversion.Convertable

Methods

toExponential :: Int -> Double -> Text

toPrecision :: Int -> Double -> Text

toFixed :: Int -> Double -> Text

toShortest :: Double -> Text

Convertable Double Builder

Defined in Data.Double.Conversion.Convertable

Methods

toExponential :: Int -> Double -> Builder

toPrecision :: Int -> Double -> Builder

toFixed :: Int -> Double -> Builder

toShortest :: Double -> Builder

Convertable Float Builder

Defined in Data.Double.Conversion.Convertable

Methods

toExponential :: Int -> Float -> Builder

toPrecision :: Int -> Float -> Builder

toFixed :: Int -> Float -> Builder

toShortest :: Float -> Builder

Convertable Float ByteString

Defined in Data.Double.Conversion.Convertable

Methods

toExponential :: Int -> Float -> ByteString

toPrecision :: Int -> Float -> ByteString

toFixed :: Int -> Float -> ByteString

toShortest :: Float -> ByteString

Convertable Float Text

Defined in Data.Double.Conversion.Convertable

Methods

toExponential :: Int -> Float -> Text

toPrecision :: Int -> Float -> Text

toFixed :: Int -> Float -> Text

toShortest :: Float -> Text

Convertable Float Builder

Defined in Data.Double.Conversion.Convertable

Methods

toExponential :: Int -> Float -> Builder

toPrecision :: Int -> Float -> Builder

toFixed :: Int -> Float -> Builder

toShortest :: Float -> Builder