text-conversions

Safe conversions between textual types


Keywords
library, Propose Tags , Skip to Readme, , Index, Quick Jump, Data.Text.Conversions, text-conversions-0.3.1.1.tar.gz, browse, Package description, package maintainers, edit package information , 0.3.1, For more details, see the documentation on Hackage.
License
ISC
Install
cabal install text-conversions-0.3.1.1

Documentation

text-conversions Build Status Hackage

This is a small library to ease the pain when converting between the many different string types in Haskell. Unlike some other libraries that attempt to solve the same problem, text-conversions is:

  • Safe. This library treats binary data (aka ByteString) like binary data, and it does not assume a particular encoding, nor does it ever throw exceptions when failing to decode. It does, however, provide failable conversions between binary data and textual data.

  • Extensible. It’s easy to add or derive your own instances of the typeclasses to use your own types through the same interface.

Here’s an example of using text-conversions to convert between textual types:

> convertText ("hello" :: String) :: Text
"hello"

And here’s an example of converting from UTF-8 encoded binary data to a textual format:

> decodeConvertText (UTF8 ("hello" :: ByteString)) :: Maybe Text
Just "hello"
> decodeConvertText (UTF8 ("\xc3\x28" :: ByteString)) :: Maybe Text
Nothing

For more details, see the documentation on Hackage.