Struct Config

impl Config

fn use_std3_ascii_rules(self, value: bool) -> Self

Whether to enforce STD3 or WHATWG URL Standard ASCII deny list.

true for STD3, false for no deny list.

Note that true rejects pseudo-hosts used by various TXT record-based protocols.

fn transitional_processing(self, value: bool) -> Self

Whether to enable (deprecated) transitional processing.

Note that Firefox, Safari, and Chrome do not use transitional processing.

fn verify_dns_length(self, value: bool) -> Self

Whether the VerifyDNSLength operation should be performed by to_ascii.

For compatibility with previous behavior, even when set to true, the trailing root label dot is allowed contrary to the spec.

fn check_hyphens(self, value: bool) -> Self

Whether to enforce STD3 rules for hyphen placement.

true to deny hyphens in the first and last positions. false to not enforce hyphen placement.

Note that for backward compatibility this is not the same as UTS 46 CheckHyphens, which also disallows hyphens in the third and fourth positions.

Note that true rejects real-world names, including some GitHub user pages.

fn use_idna_2008_rules(self, value: bool) -> Self

Obsolete method retained to ease migration. The argument must be false.

Panics

If the argument is true.

fn to_ascii(self, domain: &str) -> Result<String, Errors>

UTS 46 ToASCII

fn to_unicode(self, domain: &str) -> (String, Result<(), Errors>)

UTS 46 ToUnicode