Haskus.Format.Binary.Endianness

Byte order ("endianness")

Indicate in which order bytes are stored in memory for multi-bytes types. Big-endian means that most-significant bytes come first. Little-endian means that least-significant bytes come first.

Documentation

data Endianness

Endianness

Constructors

LittleEndian

Less significant bytes first

BigEndian

Most significant bytes first

Instances

Enum Endianness

Methods

succ :: Endianness -> Endianness

pred :: Endianness -> Endianness

toEnum :: Int -> Endianness

fromEnum :: Endianness -> Int

enumFrom :: Endianness -> [Endianness]

enumFromThen :: Endianness -> Endianness -> [Endianness]

enumFromTo :: Endianness -> Endianness -> [Endianness]

enumFromThenTo :: Endianness -> Endianness -> Endianness -> [Endianness]

Eq Endianness

Methods

(==) :: Endianness -> Endianness -> Bool

(/=) :: Endianness -> Endianness -> Bool

Show Endianness

Methods

showsPrec :: Int -> Endianness -> ShowS

show :: Endianness -> String

showList :: [Endianness] -> ShowS

CEnum Endianness

Methods

fromCEnum :: Integral b => Endianness -> b

toCEnum :: Integral b => b -> Endianness

data WordGetters

Word getter

Constructors

WordGetters

Fields

• wordGetter8 :: Get Word8

  Read a Word8

• wordGetter16 :: Get Word16

  Read a Word16

• wordGetter32 :: Get Word32

  Read a Word132

• wordGetter64 :: Get Word64

  Read a Word64

data WordPutters

Word putters

Constructors

WordPutters

Fields

• wordPutter8 :: Word8 -> Put

  Write a Word8

• wordPutter16 :: Word16 -> Put

  Write a Word16

• wordPutter32 :: Word32 -> Put

  Write a Word132

• wordPutter64 :: Word64 -> Put

  Write a Word64

getWordGetters :: Endianness -> WordGetters

Get getters for the given endianness

getWordPutters :: Endianness -> WordPutters

Get putters for the given endianness

data WordSize

Size of a machine word

Constructors

WordSize32

32-bit

WordSize64

64-bit

Instances

Eq WordSize

Methods

(==) :: WordSize -> WordSize -> Bool

(/=) :: WordSize -> WordSize -> Bool

Show WordSize

Methods

showsPrec :: Int -> WordSize -> ShowS

show :: WordSize -> String

showList :: [WordSize] -> ShowS

data ExtendedWordGetters

Extended word getters

Constructors

ExtendedWordGetters

Fields

• extwordGetter8 :: Get Word8

  Read a Word8

• extwordGetter16 :: Get Word16

  Read a Word16

• extwordGetter32 :: Get Word32

  Read a Word132

• extwordGetter64 :: Get Word64

  Read a Word64

• extwordGetterN :: Get Word64

  Read a native size word into a Word64

data ExtendedWordPutters

Extended word putters

Constructors

ExtendedWordPutters

Fields

• extwordPutter8 :: Word8 -> Put

  Write a Word8

• extwordPutter16 :: Word16 -> Put

  Write a Word16

• extwordPutter32 :: Word32 -> Put

  Write a Word132

• extwordPutter64 :: Word64 -> Put

  Write a Word64

• extwordPutterN :: Word64 -> Put

  Write a Word64 into a native size word

getExtendedWordGetters :: Endianness -> WordSize -> ExtendedWordGetters

Return extended getters

getExtendedWordPutters :: Endianness -> WordSize -> ExtendedWordPutters

Return extended putters

getHostEndianness :: IO Endianness

Detect the endianness of the host memory

hostEndianness :: Endianness

Detected host endianness

class ByteReversable w where

Reverse bytes in a word

Minimal complete definition

reverseBytes

Methods

reverseBytes :: w -> w

hostToBigEndian :: w -> w

bigEndianToHost :: w -> w

hostToLittleEndian :: w -> w

littleEndianToHost :: w -> w

Instances

ByteReversable Word8

Methods

reverseBytes :: Word8 -> Word8

hostToBigEndian :: Word8 -> Word8

bigEndianToHost :: Word8 -> Word8

hostToLittleEndian :: Word8 -> Word8

littleEndianToHost :: Word8 -> Word8

ByteReversable Word16

Methods

reverseBytes :: Word16 -> Word16

hostToBigEndian :: Word16 -> Word16

bigEndianToHost :: Word16 -> Word16

hostToLittleEndian :: Word16 -> Word16

littleEndianToHost :: Word16 -> Word16

ByteReversable Word32

Methods

reverseBytes :: Word32 -> Word32

hostToBigEndian :: Word32 -> Word32

bigEndianToHost :: Word32 -> Word32

hostToLittleEndian :: Word32 -> Word32

littleEndianToHost :: Word32 -> Word32

ByteReversable Word64

Methods

reverseBytes :: Word64 -> Word64

hostToBigEndian :: Word64 -> Word64

bigEndianToHost :: Word64 -> Word64

hostToLittleEndian :: Word64 -> Word64

littleEndianToHost :: Word64 -> Word64

newtype AsBigEndian a

Force a data to be read/stored as big-endian

Constructors

AsBigEndian a

Instances

Enum a => Enum (AsBigEndian a)

Methods

succ :: AsBigEndian a -> AsBigEndian a

pred :: AsBigEndian a -> AsBigEndian a

toEnum :: Int -> AsBigEndian a

fromEnum :: AsBigEndian a -> Int

enumFrom :: AsBigEndian a -> [AsBigEndian a]

enumFromThen :: AsBigEndian a -> AsBigEndian a -> [AsBigEndian a]

enumFromTo :: AsBigEndian a -> AsBigEndian a -> [AsBigEndian a]

enumFromThenTo :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a -> [AsBigEndian a]

Eq a => Eq (AsBigEndian a)

Methods

(==) :: AsBigEndian a -> AsBigEndian a -> Bool

(/=) :: AsBigEndian a -> AsBigEndian a -> Bool

Integral a => Integral (AsBigEndian a)

Methods

quot :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

rem :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

div :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

mod :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

quotRem :: AsBigEndian a -> AsBigEndian a -> (AsBigEndian a, AsBigEndian a)

divMod :: AsBigEndian a -> AsBigEndian a -> (AsBigEndian a, AsBigEndian a)

toInteger :: AsBigEndian a -> Integer

Num a => Num (AsBigEndian a)

Methods

(+) :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

(-) :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

(*) :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

negate :: AsBigEndian a -> AsBigEndian a

abs :: AsBigEndian a -> AsBigEndian a

signum :: AsBigEndian a -> AsBigEndian a

fromInteger :: Integer -> AsBigEndian a

Ord a => Ord (AsBigEndian a)

Methods

compare :: AsBigEndian a -> AsBigEndian a -> Ordering

(<) :: AsBigEndian a -> AsBigEndian a -> Bool

(<=) :: AsBigEndian a -> AsBigEndian a -> Bool

(>) :: AsBigEndian a -> AsBigEndian a -> Bool

(>=) :: AsBigEndian a -> AsBigEndian a -> Bool

max :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

min :: AsBigEndian a -> AsBigEndian a -> AsBigEndian a

Real a => Real (AsBigEndian a)

Methods

toRational :: AsBigEndian a -> Rational

Show a => Show (AsBigEndian a)

Methods

showsPrec :: Int -> AsBigEndian a -> ShowS

show :: AsBigEndian a -> String

showList :: [AsBigEndian a] -> ShowS

(ByteReversable a, Storable a) => Storable (AsBigEndian a)

Methods

peekIO :: Ptr (AsBigEndian a) -> IO (AsBigEndian a)

pokeIO :: Ptr (AsBigEndian a) -> AsBigEndian a -> IO ()

alignment :: AsBigEndian a -> Word

sizeOf :: AsBigEndian a -> Word

(ByteReversable a, StaticStorable a) => StaticStorable (AsBigEndian a)

Associated Types

type SizeOf (AsBigEndian a) :: Nat

type Alignment (AsBigEndian a) :: Nat

Methods

staticPeekIO :: Ptr (AsBigEndian a) -> IO (AsBigEndian a)

staticPokeIO :: Ptr (AsBigEndian a) -> AsBigEndian a -> IO ()

type SizeOf (AsBigEndian a)

type SizeOf (AsBigEndian a) = SizeOf a

type Alignment (AsBigEndian a)

type Alignment (AsBigEndian a) = Alignment a

newtype AsLittleEndian a

Force a data to be read/stored as little-endian

Constructors

AsLittleEndian a

Instances

Enum a => Enum (AsLittleEndian a)

Methods

succ :: AsLittleEndian a -> AsLittleEndian a

pred :: AsLittleEndian a -> AsLittleEndian a

toEnum :: Int -> AsLittleEndian a

fromEnum :: AsLittleEndian a -> Int

enumFrom :: AsLittleEndian a -> [AsLittleEndian a]

enumFromThen :: AsLittleEndian a -> AsLittleEndian a -> [AsLittleEndian a]

enumFromTo :: AsLittleEndian a -> AsLittleEndian a -> [AsLittleEndian a]

enumFromThenTo :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a -> [AsLittleEndian a]

Eq a => Eq (AsLittleEndian a)

Methods

(==) :: AsLittleEndian a -> AsLittleEndian a -> Bool

(/=) :: AsLittleEndian a -> AsLittleEndian a -> Bool

Integral a => Integral (AsLittleEndian a)

Methods

quot :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

rem :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

div :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

mod :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

quotRem :: AsLittleEndian a -> AsLittleEndian a -> (AsLittleEndian a, AsLittleEndian a)

divMod :: AsLittleEndian a -> AsLittleEndian a -> (AsLittleEndian a, AsLittleEndian a)

toInteger :: AsLittleEndian a -> Integer

Num a => Num (AsLittleEndian a)

Methods

(+) :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

(-) :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

(*) :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

negate :: AsLittleEndian a -> AsLittleEndian a

abs :: AsLittleEndian a -> AsLittleEndian a

signum :: AsLittleEndian a -> AsLittleEndian a

fromInteger :: Integer -> AsLittleEndian a

Ord a => Ord (AsLittleEndian a)

Methods

compare :: AsLittleEndian a -> AsLittleEndian a -> Ordering

(<) :: AsLittleEndian a -> AsLittleEndian a -> Bool

(<=) :: AsLittleEndian a -> AsLittleEndian a -> Bool

(>) :: AsLittleEndian a -> AsLittleEndian a -> Bool

(>=) :: AsLittleEndian a -> AsLittleEndian a -> Bool

max :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

min :: AsLittleEndian a -> AsLittleEndian a -> AsLittleEndian a

Real a => Real (AsLittleEndian a)

Methods

toRational :: AsLittleEndian a -> Rational

Show a => Show (AsLittleEndian a)

Methods

showsPrec :: Int -> AsLittleEndian a -> ShowS

show :: AsLittleEndian a -> String

showList :: [AsLittleEndian a] -> ShowS

(ByteReversable a, Storable a) => Storable (AsLittleEndian a)

Methods

peekIO :: Ptr (AsLittleEndian a) -> IO (AsLittleEndian a)

pokeIO :: Ptr (AsLittleEndian a) -> AsLittleEndian a -> IO ()

alignment :: AsLittleEndian a -> Word

sizeOf :: AsLittleEndian a -> Word

(ByteReversable a, StaticStorable a) => StaticStorable (AsLittleEndian a)

Associated Types

type SizeOf (AsLittleEndian a) :: Nat

type Alignment (AsLittleEndian a) :: Nat

Methods

staticPeekIO :: Ptr (AsLittleEndian a) -> IO (AsLittleEndian a)

staticPokeIO :: Ptr (AsLittleEndian a) -> AsLittleEndian a -> IO ()

type SizeOf (AsLittleEndian a)

type SizeOf (AsLittleEndian a) = SizeOf a

type Alignment (AsLittleEndian a)

type Alignment (AsLittleEndian a) = Alignment a