| Copyright | (c) 2020-2026 Emily Pillmore |
|---|---|
| License | BSD-style |
| Maintainer | Emily Pillmore <emilypi@cohomolo.gy> |
| Stability | stable |
| Portability | non-portable |
| Safe Haskell | None |
| Language | Haskell2010 |
Data.ByteString.Short.Base16
Description
This module contains ShortByteString-valued combinators for
implementing the RFC 4648 specification of the Base16
encoding format. This includes lenient decoding variants, as well as
internal and external validation for canonicity.
Synopsis
- encodeBase16 :: ShortByteString -> Base16 ShortText
- encodeBase16' :: ShortByteString -> Base16 ShortByteString
- decodeBase16 :: Base16 ShortByteString -> ShortByteString
- decodeBase16' :: Base16 ShortText -> ShortByteString
- decodeBase16Untyped :: ShortByteString -> Either Text ShortByteString
- decodeBase16Lenient :: ShortByteString -> ShortByteString
- parseBase16 :: ShortByteString -> Either Text (Base16 ShortByteString)
Documentation
encodeBase16 :: ShortByteString -> Base16 ShortText Source #
Encode a ShortByteString value as Base16 ShortText
See: RFC-4648 section 8
Examples:
>>>encodeBase16 "Sun""53756e"
Since: 0.3.0.0
encodeBase16' :: ShortByteString -> Base16 ShortByteString Source #
Encode a ShortByteString value as a Base16 ShortByteString value
See: RFC-4648 section 8
Examples:
>>>encodeBase16' "Sun""53756e"
decodeBase16 :: Base16 ShortByteString -> ShortByteString Source #
Decode a Base16-encoded ShortByteString value.
See: RFC-4648 section 8
Examples:
>>>decodeBase16 $ assertBase16 "53756e""Sun"
decodeBase16' :: Base16 ShortText -> ShortByteString Source #
Decode Base16-encoded ShortText value.
See: RFC-4648 section 8
Examples:
>>>decodeBase16' $ assertBase16 "53756e""Sun"
decodeBase16Untyped :: ShortByteString -> Either Text ShortByteString Source #
Decode an untyped Base16-encoded ByteString value with error-checking.
See: RFC-4648 section 8
Examples:
>>>decodeBase16Untyped "53756e"Right "Sun"
>>>decodeBase16Untyped "6x"Left "invalid character at offset: 1"
decodeBase16Lenient :: ShortByteString -> ShortByteString Source #
Decode an untyped Base16-encoded ShortByteString value leniently, using a
strategy that never fails
N.B.: this is not RFC 4648-compliant
Examples:
>>>decodeBase16Lenient "53756e""Sun"
>>>decodeBase16Lenient "6x6x""f"
parseBase16 :: ShortByteString -> Either Text (Base16 ShortByteString) Source #
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.
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