Struct idna::Config

pub struct Config {
    use_std3_ascii_rules: bool,
    transitional_processing: bool,
    verify_dns_length: bool,
    check_hyphens: bool,
}

👎Deprecated

Deprecated configuration API.

Fields

use_std3_ascii_rules: bool

👎Deprecated

transitional_processing: bool

👎Deprecated

verify_dns_length: bool

👎Deprecated

check_hyphens: bool

👎Deprecated

Implementations

impl Config

pub 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.

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

Whether to enable (deprecated) transitional processing.

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

pub 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.

pub 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.

pub 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 deny_list(&self) -> AsciiDenyList

Compute the deny list

fn hyphens(&self) -> Hyphens

Compute the hyphen mode

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

UTS 46 ToASCII

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

UTS 46 ToUnicode

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Config

The defaults are that of beStrict=false in the WHATWG URL Standard

fn default() -> Self

Returns the “default value” for a type.

impl Copy for Config