cereal-0.4.0.1: A binary serialization library

StabilityPortability :
MaintainerTrevor Elliott <trevor@galois.com>
Safe HaskellNone

Data.Serialize.Put

Contents

Description

The Put monad. A monad for efficiently constructing bytestrings.

Synopsis

The Put type

type Put = PutM ()Source

Put merely lifts Builder into a Writer monad, applied to ().

newtype PutM a Source

The PutM type. A Writer monad over the efficient Builder monoid.

Constructors

Put 

Fields

unPut :: PairS a
 

type Putter a = a -> PutSource

runPut :: Put -> ByteStringSource

Run the Put monad with a serialiser

runPutM :: PutM a -> (a, ByteString)Source

Run the Put monad with a serialiser and get its result

runPutLazy :: Put -> ByteStringSource

Run the Put monad with a serialiser

runPutMLazy :: PutM a -> (a, ByteString)Source

Run the Put monad with a serialiser

execPut :: PutM a -> BuilderSource

Run the Put monad

Flushing the implicit parse state

flush :: PutSource

Pop the ByteString we have constructed so far, if any, yielding a new chunk in the result ByteString.

Primitives

putWord8 :: Putter Word8Source

Efficiently write a byte into the output buffer

putByteString :: Putter ByteStringSource

An efficient primitive to write a strict ByteString into the output buffer. It flushes the current buffer, and writes the argument into a new chunk.

putLazyByteString :: Putter ByteStringSource

Write a lazy ByteString efficiently, simply appending the lazy ByteString chunks to the output buffer

Big-endian primitives

putWord16be :: Putter Word16Source

Write a Word16 in big endian format

putWord32be :: Putter Word32Source

Write a Word32 in big endian format

putWord64be :: Putter Word64Source

Write a Word64 in big endian format

Little-endian primitives

putWord16le :: Putter Word16Source

Write a Word16 in little endian format

putWord32le :: Putter Word32Source

Write a Word32 in little endian format

putWord64le :: Putter Word64Source

Write a Word64 in little endian format

Host-endian, unaligned writes

putWordhost :: Putter WordSource

O(1). Write a single native machine word. The word is written in host order, host endian form, for the machine you're on. On a 64 bit machine the Word is an 8 byte value, on a 32 bit machine, 4 bytes. Values written this way are not portable to different endian or word sized machines, without conversion.

putWord16host :: Putter Word16Source

O(1). Write a Word16 in native host order and host endianness. For portability issues see putWordhost.

putWord32host :: Putter Word32Source

O(1). Write a Word32 in native host order and host endianness. For portability issues see putWordhost.

putWord64host :: Putter Word64Source

O(1). Write a Word64 in native host order On a 32 bit machine we write two host order Word32s, in big endian form. For portability issues see putWordhost.

Containers

putTwoOf :: Putter a -> Putter b -> Putter (a, b)Source

putIArrayOf :: (Ix i, IArray a e) => Putter i -> Putter e -> Putter (a i e)Source

putMapOf :: Ord k => Putter k -> Putter a -> Putter (Map k a)Source