text-printer-0.5: Abstract interface for text builders/printers.

Safe HaskellNone
LanguageHaskell2010

Text.Printer.Integral

Contents

Description

Print integral numbers in common positional numeral systems.

Synopsis

Positional systems

class PositionalSystem s where Source #

Positional numeral system.

Methods

systemName :: s -> String Source #

The name of the system (e.g. "binary", "decimal").

radixIn :: Num α => s -> α Source #

The radix of the system.

isDigitIn :: s -> Char -> Bool Source #

Test if a character is a digit.

isNzDigitIn :: s -> Char -> Bool Source #

Test if a character is a non-zero digit.

fromDigitIn :: Num α => s -> Char -> Maybe α Source #

Map digits to the corresponding numbers. Return Nothing on other inputs.

fromNzDigitIn :: Num α => s -> Char -> Maybe α Source #

Map non-zero digits to the corresponding numbers. Return Nothing on other inputs.

unsafeFromDigitIn :: Num α => s -> Char -> α Source #

Map digits to the corresponding numbers. No checks are performed.

intToDigitIn :: s -> Int -> Char Source #

Map Int values to the corresponding digits. Inputs must be non-negative and less than the radix.

printDigitIn :: Printer p => s -> Char -> p Source #

Print a digit.

printZeroIn :: Printer p => s -> p Source #

Instances

PositionalSystem UpHex Source # 
PositionalSystem LowHex Source # 
PositionalSystem Hexadecimal Source # 
PositionalSystem Decimal Source # 
PositionalSystem Octal Source # 
PositionalSystem Binary Source # 

class PositionalSystem s => BitSystem s where Source #

Positonal numeral system with a power of two radix.

Minimal complete definition

digitBitsIn, digitMaskIn, lastDigitIn

Methods

digitBitsIn :: s -> Int Source #

Numer of bits occupied by a digit.

digitMaskIn :: Num α => s -> α Source #

The number that has digitBitsIn least significant bits set to ones and all the other bits set to zeroes.

lastDigitIn :: Bits α => s -> α -> Int Source #

Map the last digit of a number to the corresponding Int value.

data Binary Source #

The binary numeral system.

Constructors

Binary 

Instances

Eq Binary Source # 

Methods

(==) :: Binary -> Binary -> Bool #

(/=) :: Binary -> Binary -> Bool #

Ord Binary Source # 
Read Binary Source # 
Show Binary Source # 
Generic Binary Source # 

Associated Types

type Rep Binary :: * -> * #

Methods

from :: Binary -> Rep Binary x #

to :: Rep Binary x -> Binary #

BitSystem Binary Source # 

Methods

digitBitsIn :: Binary -> Int Source #

digitMaskIn :: Num α => Binary -> α Source #

lastDigitIn :: Bits α => Binary -> α -> Int Source #

PositionalSystem Binary Source # 
type Rep Binary Source # 
type Rep Binary = D1 (MetaData "Binary" "Text.Printer.Integral" "text-printer-0.5-6BKOWR0cejT2opc7OlwZvB" False) (C1 (MetaCons "Binary" PrefixI False) U1)

data Octal Source #

The octal numeral system.

Constructors

Octal 

Instances

Eq Octal Source # 

Methods

(==) :: Octal -> Octal -> Bool #

(/=) :: Octal -> Octal -> Bool #

Ord Octal Source # 

Methods

compare :: Octal -> Octal -> Ordering #

(<) :: Octal -> Octal -> Bool #

(<=) :: Octal -> Octal -> Bool #

(>) :: Octal -> Octal -> Bool #

(>=) :: Octal -> Octal -> Bool #

max :: Octal -> Octal -> Octal #

min :: Octal -> Octal -> Octal #

Read Octal Source # 
Show Octal Source # 

Methods

showsPrec :: Int -> Octal -> ShowS #

show :: Octal -> String #

showList :: [Octal] -> ShowS #

Generic Octal Source # 

Associated Types

type Rep Octal :: * -> * #

Methods

from :: Octal -> Rep Octal x #

to :: Rep Octal x -> Octal #

BitSystem Octal Source # 

Methods

digitBitsIn :: Octal -> Int Source #

digitMaskIn :: Num α => Octal -> α Source #

lastDigitIn :: Bits α => Octal -> α -> Int Source #

PositionalSystem Octal Source # 
type Rep Octal Source # 
type Rep Octal = D1 (MetaData "Octal" "Text.Printer.Integral" "text-printer-0.5-6BKOWR0cejT2opc7OlwZvB" False) (C1 (MetaCons "Octal" PrefixI False) U1)

data Decimal Source #

The decimal numeral system.

Constructors

Decimal 

Instances

Eq Decimal Source # 

Methods

(==) :: Decimal -> Decimal -> Bool #

(/=) :: Decimal -> Decimal -> Bool #

Ord Decimal Source # 
Read Decimal Source # 
Show Decimal Source # 
Generic Decimal Source # 

Associated Types

type Rep Decimal :: * -> * #

Methods

from :: Decimal -> Rep Decimal x #

to :: Rep Decimal x -> Decimal #

PositionalSystem Decimal Source # 
type Rep Decimal Source # 
type Rep Decimal = D1 (MetaData "Decimal" "Text.Printer.Integral" "text-printer-0.5-6BKOWR0cejT2opc7OlwZvB" False) (C1 (MetaCons "Decimal" PrefixI False) U1)

data Hexadecimal Source #

The hexadecimal numeral system.

Constructors

Hexadecimal 

Instances

Eq Hexadecimal Source # 
Ord Hexadecimal Source # 
Read Hexadecimal Source # 
Show Hexadecimal Source # 
Generic Hexadecimal Source # 

Associated Types

type Rep Hexadecimal :: * -> * #

BitSystem Hexadecimal Source # 
PositionalSystem Hexadecimal Source # 
type Rep Hexadecimal Source # 
type Rep Hexadecimal = D1 (MetaData "Hexadecimal" "Text.Printer.Integral" "text-printer-0.5-6BKOWR0cejT2opc7OlwZvB" False) (C1 (MetaCons "Hexadecimal" PrefixI False) U1)

data LowHex Source #

The hexadecimal numeral system, using lower case digits.

Constructors

LowHex 

Instances

Eq LowHex Source # 

Methods

(==) :: LowHex -> LowHex -> Bool #

(/=) :: LowHex -> LowHex -> Bool #

Ord LowHex Source # 
Read LowHex Source # 
Show LowHex Source # 
Generic LowHex Source # 

Associated Types

type Rep LowHex :: * -> * #

Methods

from :: LowHex -> Rep LowHex x #

to :: Rep LowHex x -> LowHex #

BitSystem LowHex Source # 

Methods

digitBitsIn :: LowHex -> Int Source #

digitMaskIn :: Num α => LowHex -> α Source #

lastDigitIn :: Bits α => LowHex -> α -> Int Source #

PositionalSystem LowHex Source # 
type Rep LowHex Source # 
type Rep LowHex = D1 (MetaData "LowHex" "Text.Printer.Integral" "text-printer-0.5-6BKOWR0cejT2opc7OlwZvB" False) (C1 (MetaCons "LowHex" PrefixI False) U1)

data UpHex Source #

The hexadecimal numeral system, using upper case digits.

Constructors

UpHex 

Instances

Eq UpHex Source # 

Methods

(==) :: UpHex -> UpHex -> Bool #

(/=) :: UpHex -> UpHex -> Bool #

Ord UpHex Source # 

Methods

compare :: UpHex -> UpHex -> Ordering #

(<) :: UpHex -> UpHex -> Bool #

(<=) :: UpHex -> UpHex -> Bool #

(>) :: UpHex -> UpHex -> Bool #

(>=) :: UpHex -> UpHex -> Bool #

max :: UpHex -> UpHex -> UpHex #

min :: UpHex -> UpHex -> UpHex #

Read UpHex Source # 
Show UpHex Source # 

Methods

showsPrec :: Int -> UpHex -> ShowS #

show :: UpHex -> String #

showList :: [UpHex] -> ShowS #

Generic UpHex Source # 

Associated Types

type Rep UpHex :: * -> * #

Methods

from :: UpHex -> Rep UpHex x #

to :: Rep UpHex x -> UpHex #

BitSystem UpHex Source # 

Methods

digitBitsIn :: UpHex -> Int Source #

digitMaskIn :: Num α => UpHex -> α Source #

lastDigitIn :: Bits α => UpHex -> α -> Int Source #

PositionalSystem UpHex Source # 
type Rep UpHex Source # 
type Rep UpHex = D1 (MetaData "UpHex" "Text.Printer.Integral" "text-printer-0.5-6BKOWR0cejT2opc7OlwZvB" False) (C1 (MetaCons "UpHex" PrefixI False) U1)

Numeral printers

nonNegative :: (PositionalSystem s, Integral α, Printer p) => s -> α -> p Source #

Print a non-negative number in the specified positional numeral system.

nnBinary :: (Integral α, Printer p) => α -> p Source #

Print a non-negative number in the binary numeral system.

nnOctal :: (Integral α, Printer p) => α -> p Source #

Print a non-negative number in the octal numeral system.

nnDecimal :: (Integral α, Printer p) => α -> p Source #

Print a non-negative number in the decimal numeral system.

nnLowHex :: (Integral α, Printer p) => α -> p Source #

Print a non-negative number in the hexadecimal numeral system using lower case digits.

nnUpHex :: (Integral α, Printer p) => α -> p Source #

Print a non-negative number in the hexadecimal numeral system using upper case digits.

nnBits :: (BitSystem s, Num α, Bits α, Printer p) => s -> α -> p Source #

Print a non-negative binary number in the specified positional numeral system.

nnBinaryBits :: (Num α, Bits α, Printer p) => α -> p Source #

Print a non-negative binary number in the binary numeral system.

nnOctalBits :: (Num α, Bits α, Printer p) => α -> p Source #

Print a non-negative binary number in the octal numeral system.

nnLowHexBits :: (Num α, Bits α, Printer p) => α -> p Source #

Print a non-negative binary number in the hexadecimal numeral system using lower case digits.

nnUpHexBits :: (Num α, Bits α, Printer p) => α -> p Source #

Print a non-negative binary number in the hexadecimal numeral system using upper case digits.

nonPositive :: (PositionalSystem s, Integral α, Printer p) => s -> α -> p Source #

Print a non-positive number in the specified positional numeral system. For example, nonPositive Decimal (-123) would print "123".

npBinary :: (Integral α, Printer p) => α -> p Source #

Print a non-positive number in the binary numeral system.

npOctal :: (Integral α, Printer p) => α -> p Source #

Print a non-positive number in the octal numeral system.

npDecimal :: (Integral α, Printer p) => α -> p Source #

Print a non-positive number in the decimal numeral system.

npLowHex :: (Integral α, Printer p) => α -> p Source #

Print a non-positive number in the hexadecimal numeral system using lower case digits.

npUpHex :: (Integral α, Printer p) => α -> p Source #

Print a non-positive number in the hexadecimal numeral system using upper case digits.

npBits :: (BitSystem s, Ord α, Num α, Bits α, Printer p) => s -> α -> p Source #

Print a non-positive two-compliment binary number in the specified positional numeral system. For example, npBits UpHex (-0xABC) would print "ABC".

npBinaryBits :: (Ord α, Num α, Bits α, Printer p) => α -> p Source #

Print a non-positive binary number in the binary numeral system.

npOctalBits :: (Ord α, Num α, Bits α, Printer p) => α -> p Source #

Print a non-positive binary number in the octal numeral system.

npLowHexBits :: (Ord α, Num α, Bits α, Printer p) => α -> p Source #

Print a non-positive binary number in the hexadecimal numeral system using lower case digits.

npUpHexBits :: (Ord α, Num α, Bits α, Printer p) => α -> p Source #

Print a non-positive binary number in the hexadecimal numeral system using upper case digits.

number' Source #

Arguments

:: (PositionalSystem s, Ord α, Integral α, Printer p) 
=> s 
-> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a number in the specified positional numeral system.

number :: (PositionalSystem s, Ord α, Integral α, Printer p) => s -> α -> p Source #

Print a number in the specified positional numeral system. Negative values are prefixed with a minus sign.

binary' Source #

Arguments

:: (Ord α, Integral α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a number in the binary numeral system.

binary :: (Ord α, Integral α, Printer p) => α -> p Source #

Print a number in the binary numeral system. Negative values are prefixed with a minus sign.

octal' Source #

Arguments

:: (Ord α, Integral α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a number in the octal numeral system.

octal :: (Ord α, Integral α, Printer p) => α -> p Source #

Print a number in the octal numeral system. Negative values are prefixed with a minus sign.

decimal' Source #

Arguments

:: (Ord α, Integral α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a number in the decimal numeral system.

decimal :: (Ord α, Integral α, Printer p) => α -> p Source #

Print a number in the decimal numeral system. Negative values are prefixed with a minus sign.

lowHex' Source #

Arguments

:: (Ord α, Integral α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a number in the hexadecimal numeral system using lower case digits.

lowHex :: (Ord α, Integral α, Printer p) => α -> p Source #

Print a number in the hexadecimal numeral system using lower case digits. Negative values are prefixed with a minus sign.

upHex' Source #

Arguments

:: (Ord α, Integral α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a number in the hexadecimal numeral system using upper case digits.

upHex :: (Ord α, Integral α, Printer p) => α -> p Source #

Print a number in the hexadecimal numeral system using upper case digits. Negative values are prefixed with a minus sign.

bits' Source #

Arguments

:: (BitSystem s, Ord α, Num α, Bits α, Printer p) 
=> s 
-> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a binary number in the specified positional numeral system.

bits :: (BitSystem s, Ord α, Num α, Bits α, Printer p) => s -> α -> p Source #

Print a binary number in the specified positional numeral system. Negative values are prefixed with a minus sign.

binaryBits' Source #

Arguments

:: (Ord α, Num α, Bits α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a binary number in the binary numeral system.

binaryBits :: (Ord α, Num α, Bits α, Printer p) => α -> p Source #

Print a binary number in the binary numeral system. Negative values are prefixed with a minus sign.

octalBits' Source #

Arguments

:: (Ord α, Num α, Bits α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a binary number in the octal numeral system.

octalBits :: (Ord α, Num α, Bits α, Printer p) => α -> p Source #

Print a binary number in the octal numeral system. Negative values are prefixed with a minus sign.

lowHexBits' Source #

Arguments

:: (Ord α, Num α, Bits α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a binary number in the hexadecimal numeral system using lower case digits.

lowHexBits :: (Ord α, Num α, Bits α, Printer p) => α -> p Source #

Print a binary number in the hexadecimal numeral system using lower case digits. Negative values are prefixed with a minus sign.

upHexBits' Source #

Arguments

:: (Ord α, Num α, Bits α, Printer p) 
=> p

Prefix for negative values

-> p

Zero printer

-> p

Prefix for positive values

-> α 
-> p 

Print a binary number in the hexadecimal numeral system using upper case digits.

upHexBits :: (Ord α, Num α, Bits α, Printer p) => α -> p Source #

Print a binary number in the hexadecimal numeral system using upper case digits. Negative values are prefixed with a minus sign.