Data.CompactString.Encodings

Different encodings of characters into bytes.

Unicode encodings

data UTF8

Tag representing the UTF-8 encoding. Use CompactString UTF8 for UTF-8 encoded strings.

Constructors

UTF8

Instances

Encoding UTF8

data BE

Tag representing big endian encoding

Constructors

BE

Instances

Endian BE

data LE

Tag representing little endian encoding

Constructors

LE

Instances

Endian LE

type Native = LE

The platform native endianness

data UTF16 endianness

Tag representing the UTF-16 encoding

Constructors

UTF16 endianness

Instances

Endian e => Encoding (UTF16 e)

type UTF16BE = UTF16 BE

Tag representing the big endian UTF-16 encoding, aka. UTF-16BE.

type UTF16LE = UTF16 LE

Tag representing the little endian UTF-16 encoding, aka. UTF-16LE.

type UTF16Native = UTF16 Native

Tag representing the platform native UTF-16 encoding.

data UTF32 endianness

Tag representing the UTF-32 encoding

Constructors

UTF32 endianness

Instances

Endian e => Encoding (UTF32 e)

type UTF32BE = UTF32 BE

Tag representing the big endian UTF-32 encoding, aka. UTF-32BE.

type UTF32LE = UTF32 LE

Tag representing the little endian UTF-32 encoding, aka. UTF-32LE.

type UTF32Native = UTF32 Native

Tag representing the platform native UTF-32 encoding.

Other encodings

data ASCII

Tag representing the ASCII encoding.

Constructors

ASCII

Instances

Encoding ASCII

data Latin1

Tag representing the ISO 8859-1 encoding (latin 1).

Constructors

Latin1

Instances

Encoding Latin1

Non-standard encodings

data Compact

Tag representing a custom encoding optimized for memory usage.

This encoding looks like UTF-8, but is slightly more efficient. It requires at most 3 byes per character, as opposed to 4 for UTF-8.

Encoding looks like:

                   0zzzzzzz -> 0zzzzzzz
          00yyyyyy yzzzzzzz -> 1xxxxxxx 1yyyyyyy
 000xxxxx xxyyyyyy yzzzzzzz -> 1xxxxxxx 0yyyyyyy 1zzzzzzz

The reasoning behind the tag bits is that this allows the char to be read both forwards and backwards.

Constructors

Compact

Instances

Encoding Compact