idna

Module uts46

Source
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§

AsciiDenyList
The ASCII deny list to be applied.
Uts46
An implementation of UTS #46.

Enums§

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.

Constants§

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.

Functions§

apply_ascii_deny_list_to_lower_cased_unicode 🔒
apply_ascii_deny_list_to_potentially_upper_case_ascii 🔒
check_hyphens 🔒
classify_for_punycode 🔒
glyphless_mask 🔒
Computes the mask for glyphless ASCII.
has_punycode_prefix 🔒
in_inclusive_range8 🔒
in_inclusive_range_char 🔒
is_ascii 🔒
is_passthrough_ascii_label 🔒
ldh_mask 🔒
Computes the ASCII deny list for STD3 ASCII rules.
split_ascii_fast_path_prefix 🔒
upper_case_mask 🔒
Computes the mask for upper-case ASCII.
verify_dns_length
Performs the VerifyDNSLength check on the output of the ToASCII operation.
write_punycode_label 🔒