A simple typeclass that handles converting Text to arbitrary datatypes. If you have a type that can be produced from text, implement this typeclass. However, you probably do not want to call fromText directly; call convertText, instead.

A simple typeclass that handles converting arbitrary datatypes to Text when the operation cannot fail. If you have a type that satisfies that requirement, implement this typeclass, but if the operation can fail, use DecodeText instead.

A simple typeclass that handles converting arbitrary datatypes to Text when the operation can fail. If you have a type that satisfies that requirement, implement this typeclass, but if the operation cannot fail, use ToText instead.

A function that provides a way to safely convert between arbitrary textual datatypes where the conversion to text cannot fail.

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

A function that provides a way to safely convert between arbitrary textual datatypes where the conversion to text can fail, such as decoding binary data to text. Since binary data can represent text in many different potential encodings, it is necessary to use a newtype that picks the particular encoding, like UTF8:

>>> decodeConvertText (UTF8 ("hello" :: ByteString)) :: Maybe Text
Just "hello"

Simple wrapper type that is used to select a desired encoding when encoding or decoding text from binary data, such as ByteStrings. The conversion is not partial; it will result in Nothing when a ByteString is provided with data that is not valid in UTF-8.

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

Wrapper type used to select a base 16 encoding when encoding or decoding binary data. Safe because base 16 encoding will always produce ASCII output.

Wrapper type used to select a base 64 encoding when encoding or decoding binary data. Safe because base 64 encoding will always produce ASCII output.