Blaze.ByteString.Builder.Char.Utf8

Writes and Builders for serializing Unicode characters using the UTF-8 encoding.

Writing UTF-8 encoded characters to a buffer

writeChar :: Char -> Write

Write a UTF-8 encoded Unicode character to a buffer.

Note that the control flow of writeChar is more complicated than the one of writeWord8, as the size of the write depends on the Char written. Therefore,

 fromWrite $ writeChar a `mappend` writeChar b

must not always be faster than

 fromChar a `mappend` fromChar b

Use benchmarking to make informed decisions.

Creating Builders from UTF-8 encoded characters

fromChar :: Char -> Builder

O(1). Serialize a Unicode character using the UTF-8 encoding.

fromString :: String -> Builder

O(n). Serialize a Unicode String using the UTF-8 encoding.

fromShow :: Show a => a -> Builder

O(n). Serialize a value by Showing it and UTF-8 encoding the resulting String.

fromText :: Text -> Builder

O(n). Serialize a strict Unicode Text value using the UTF-8 encoding.

Note that this function is currently faster than encodeUtf8 provided by Data.Text.Encoding. Moreover, fromText is also lazy, while TL.encodeUtf8 is strict.

fromLazyText :: Text -> Builder

O(n). Serialize a lazy Unicode Text value using the UTF-8 encoding.

Note that this function is currently faster than TL.encodeUtf8 provided by Data.Text.Lazy.Encoding.