utf8-string-0.3.8: Support for reading and writing UTF8 Strings

Portability | portable
Stability | experimental
Maintainer | emertens@galois.com
Safe Haskell | Trustworthy

Codec.Binary.UTF8.String

Description

Support for encoding UTF8 Strings to and from `[Word8]`

Synopsis

- encode :: String -> [Word8]
- decode :: [Word8] -> String
- encodeString :: String -> String
- decodeString :: String -> String
- encodeChar :: Char -> [Word8]
- isUTF8Encoded :: String -> Bool
- utf8Encode :: String -> String

# Documentation

encode :: String -> [Word8]

Encode a Haskell String to a list of Word8 values, in UTF8 format.

decode :: [Word8] -> String

Decode a UTF8 string packed into a list of Word8 values, directly to String

encodeString :: String -> String

Encode a string using `encode` and store the result in a `String`.

decodeString :: String -> String

Decode a string using `decode` using a `String` as input. | This is not safe but it is necessary if UTF-8 encoded text | has been loaded into a `String` prior to being decoded.

encodeChar :: Char -> [Word8]

Encode a single Haskell Char to a list of Word8 values, in UTF8 format.

isUTF8Encoded :: String -> Bool

`isUTF8Encoded str` tries to recognize input string as being in UTF-8 form.

utf8Encode :: String -> String

`utf8Encode str` is a convenience function; checks to see if `str` isn't UTF-8 encoded before doing so. Sometimes useful, but you are better off keeping track of the encoding so as to avoid the cost of checking.