Write a single byte.
Moduleblaze-builder-0.4.4.1Haskell98
Blaze.ByteString.Builder.Word
Writes and Builders for serializing words.
Note that for serializing a three tuple (x,y,z) of bytes (or other word
values) you should use the expression
fromWrite $ writeWord8 x `mappend` writeWord8 y `mappend` writeWord zinstead of
fromWord8 x `mappend` fromWord8 y `mappend` fromWord zThe first expression will result in a single atomic write of three bytes, while the second expression will check for each byte, if there is free space left in the output buffer. Coalescing these checks can improve performance quite a bit, as long as you use it sensibly.
Contents
Synopsis
- value writeWord8
- value writeWord16be
- value writeWord32be
- value writeWord64be
- value writeWord16le
- value writeWord32le
- value writeWord64le
- value writeWordhost
- value writeWord16host
- value writeWord32host
- value writeWord64host
- value fromWord8
- value fromWord8s
- value fromWord16be
- value fromWord32be
- value fromWord64be
- value fromWord32sbe
- value fromWord16sbe
- value fromWord64sbe
- value fromWord16le
- value fromWord32le
- value fromWord64le
- value fromWord16sle
- value fromWord32sle
- value fromWord64sle
- value fromWordhost
- value fromWord16host
- value fromWord32host
- value fromWord64host
- value fromWordshost
- value fromWord16shost
- value fromWord32shost
- value fromWord64shost
- Packageblaze-builder-0.4.4.1
- Exports33
- LanguageHaskell98
- LicenceBSD-3-Clause
- SourceWord.hs
Writing words to a buffer
Big-endian writes
Write a Word16 in big endian format.
Write a Word32 in big endian format.
Write a Word64 in big endian format.
Little-endian writes
Write a Word16 in little endian format.
Write a Word32 in big endian format.
Write a Word64 in little endian format.
Host-endian writes
Write a Word16 in native host order and host endianness.
Write a Word32 in native host order and host endianness.
Write a Word64 in native host order and host endianness.
Creating builders from words
We provide serialization functions both for singleton words as well as
for lists of words. Using these list serialization functions is much faster
than using mconcat . map fromWord<n>, as the list serialization
functions use a tighter inner loop.
Serialize a single byte.
Serialize a list of bytes.
Big-endian serialization
Serialize a Word16 in big endian format.
Serialize a Word32 in big endian format.
Serialize a Word64 in big endian format.
Serialize a list of Word32s in big endian format.
Serialize a list of Word16s in big endian format.
Serialize a list of Word64s in big endian format.
Little-endian serialization
Serialize a Word16 in little endian format.
Serialize a list of Word32s in little endian format.
Serialize a Word64 in little endian format.
Serialize a list of Word16s in little endian format.
Serialize a list of Word32s in little endian format.
Serialize a list of Word64s in little endian format.
Host-endian serialization
Serialize a single native machine Word. The Word is serialized 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.
Write a Word16 in native host order and host endianness.
Write a Word32 in native host order and host endianness.
Write a Word64 in native host order and host endianness.
Serialize a list of Words. See fromWordhost for usage considerations.
Write a list of Word16s in native host order and host endianness.
Write a list of Word32s in native host order and host endianness.
Write a Word64 in native host order and host endianness.