Module idna::uts46

Expand description

This module provides the lower-level API for UTS 46.

Uts46::process is the core that the other convenience methods build on.

UTS 46 flags map to this API as follows:

CheckHyphens - true: Hyphens::Check, false: Hyphens::Allow; the WHATWG URL Standard sets this to false for normal (non-conformance-checker) user agents.
CheckBidi - Always true; cannot be configured, since this flag is true even when WHATWG URL Standard beStrict is false.
CheckJoiners - Always true; cannot be configured, since this flag is true even when WHATWG URL Standard beStrict is false.
UseSTD3ASCIIRules - true: AsciiDenyList::STD3, false: AsciiDenyList::EMPTY; however, the check the WHATWG URL Standard performs right after the UTS 46 invocation corresponds to AsciiDenyList::URL.
Transitional_Processing - Always false but could be implemented as a preprocessing step. This flag is deprecated and for Web purposes the transition is over in the sense that all of Firefox, Safari, or Chrome set this flag to false.
VerifyDnsLength - true: DnsLength::Verify, false: DnsLength::Ignore; the WHATWG URL Standard sets this to false for normal (non-conformance-checker) user agents.
IgnoreInvalidPunycode - Always false; cannot be configured. (Not yet covered by the WHATWG URL Standard, but 2 out of 3 major browser clearly behave as if this was false).

Structs§

AlreadyAsciiLabel 🔒
DnsLength
The UTS 46 VerifyDNSLength flag.
ErrorPolicy
Policy for customizing behavior in case of an error.
Hyphens
The CheckHyphens mode.
ProcessingError
The failure outcome of Uts46::process
ProcessingSuccess
The success outcome of Uts46::process
PunycodeClassification 🔒
RtlNumeralState 🔒
For keeping track of what kind of numerals have been seen in an RTL label.

DOT_MASK 🔒
The mask for the ASCII dot.
GLYPHLESS_MASK 🔒
Bit set for glyphless ASCII.
PUNYCODE_DECODE_MAX_INPUT_LENGTH 🔒
ICU4C-compatible constraint. https://unicode-org.atlassian.net/browse/ICU-13727
PUNYCODE_ENCODE_MAX_INPUT_LENGTH 🔒
ICU4C-compatible constraint. (Note: ICU4C measures UTF-16 and we measure UTF-32. This means that we allow longer non-BMP inputs. For this implementation, the denial-of-service scaling does not depend on BMP vs. non-BMP: only the scalar values matter.)
PUNYCODE_PREFIX 🔒
PUNYCODE_PREFIX_MASK 🔒
UPPER_CASE_MASK 🔒
Bit set for upper-case ASCII.