Documentation

Encode a Text value in Base16 with padding.

See: RFC-4648 section 8

Decode a Base16-encoded lazy Text value.

See: RFC-4648 section 8

Attempt to decode a lazy 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'
  :: Text -> Either (Base16Error UnicodeException) Text

Decode a Base16-encoded lazy Text 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.

Tell whether a Text value is Base16-encoded.

Examples:

This example will fail. It conforms to the alphabet, but is not valid because it has an incorrect (odd) length.

>>> isBase16 "666f6"
False

This example will succeed because it satisfies the alphabet and is considered "valid" (i.e. of the correct size and shape).

>>> isBase16 "666f"
True

Tell whether a Text 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 Text value, use isBase16.

Examples:

This example will fail because it does not conform to the Hex alphabet.

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

This example will succeed because it satisfies the alphabet and is considered "valid" (i.e. of the correct size and shape), but is not correct base16 because it is the wrong shape.

>>> isValidBase16 "666f6"
True