Documentation

Encode a Text value in Base16.

See: RFC-4648 section 8

Examples:

>>> encodeBase16 "Sun"
"53756e"

Decode a Base16-encoded Text value.

See: RFC-4648 section 8

Examples:

>>> decodeBase16 $ assertBase16 "53756e"
"Sun"

Decode an untyped Base16-encoded Text value.

See: RFC-4648 section 8

Examples:

>>> decodeBase16Untyped "53756e"
Right "Sun"

>>> decodeBase16Untyped "6x"
Left "invalid character at offset: 1"

Attempt to decode an untyped Text value as Base16, converting from ByteString to Text according to some encoding function. In practice, This is something like decodeUtf8', which may produce an error.

See: RFC-4648 section 8

Example:

decodeBase16With decodeUtf8'
  :: ByteString -> Either (Base16Error UnicodeException) Text

Since: 0.3.0.0

Decode an untyped Base16-encoded Text value leniently.

Non-hexadecimal characters and a final unpaired hex digit are ignored. Valid UTF-8 sequences in the decoded bytes are preserved. Each invalid UTF-8 byte is interpreted as its Latin-1 character (U+0000 through U+00FF), so malformed input does not raise Unicode exceptions.

N.B.: this is not RFC 4648-compliant.

Examples:

>>> decodeBase16Lenient "53756e"
"Sun"

>>> decodeBase16Lenient "6x6x"
"f"

>>> decodeBase16Lenient "df" == "\223"
True

>>> decodeBase16Lenient "c39f" == "\223"
True

Validate an untyped Base16 value and retain its encoded representation.

Accepts even-length ASCII hexadecimal input, including upper-case and mixed-case digits. Empty input is valid. The original input is preserved, and errors match decodeBase16Untyped.

This validates the Base16 encoding, not the UTF-8 validity of its decoded payload. Use decodeBase16With with a checked conversion for text decoding.

Examples:

>>> parseBase16 "666f6"
Left "invalid bytestring size"

>>> parseBase16 "666F"
Right "666F"

>>> fmap decodeBase16 (parseBase16 "666F")
Right "fo"

>>> parseBase16 "6x"
Left "invalid character at offset: 1"

Since: 2.0