Data.Text.Short.Encoding.Base16

Encode a ShortText value in Base16 with padding.

See: RFC-4648 section 8

Examples:

>>> encodeBase16 "Sun""53756e"

Decode a Base16-encoded ShortText value.

See: RFC-4648 section 8

Examples:

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

Decode an untyped Base16-encoded ShortText value.

See: RFC-4648 section 8

Examples:

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

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

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

See: RFC-4648 section 8

Example:

decodeBase16With (fmap fromText . decodeUtf8' . fromShort)
  :: ShortByteString -> Either (Base16Error UnicodeException) ShortText

Decode an untyped Base16-encoded ShortText value leniently, using a strategy that never fails, catching unicode exceptions raised in the process of converting to text values.

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

Examples:

>>> decodeBase16Lenient "53756e""Sun"

>>> decodeBase16Lenient "6x6x""f"

Tell whether a ShortText value is Base16-encoded.

Examples:

>>> isBase16 "666f6"False

>>> isBase16 "666f"True

Tell whether a ShortText value is a valid Base16 format.

This will not tell you whether or not this is a correct Base16 representation, only that it conforms to the correct shape. To check whether it is a true Base16 encoded ShortText value, use isBase16.

Examples:

>>> isValidBase16 "666f+/6"False

>>> isValidBase16 "666f6"True