Struct UnregisteredScheme

pub struct UnregisteredScheme<'scheme> { /* private fields */ }

A scheme that is not in the registered schemes.

This is case-insensitive, and this is reflected in the equality and hash functions.

Implementations

impl UnregisteredScheme<'_>

pub fn as_borrowed(&self) -> UnregisteredScheme<'_>

Returns a new unregistered scheme which is identical but has a lifetime tied to this unregistered scheme.

pub fn as_str(&self) -> &str

Returns a str representation of the scheme.

The case-sensitivity of the original string is preserved.

Examples

use std::convert::TryFrom;

use uriparse::UnregisteredScheme;

let scheme = UnregisteredScheme::try_from("TEST-scheme").unwrap();
assert_eq!(scheme.as_str(), "TEST-scheme");

pub fn into_owned(self) -> UnregisteredScheme<'static>

Converts the UnregisteredScheme into an owned copy.

If you construct the scheme from a source with a non-static lifetime, you may run into lifetime problems due to the way the struct is designed. Calling this function will ensure that the returned value has a static lifetime.

This is different from just cloning. Cloning the scheme will just copy the references, and thus the lifetime will remain the same.

pub fn is_normalized(&self) -> bool

Returns whether the scheme is normalized.

A normalized scheme will be all lowercase.

This function runs in constant-time.

Examples

use std::convert::TryFrom;

use uriparse::UnregisteredScheme;

let scheme = UnregisteredScheme::try_from("myscheme").unwrap();
assert!(scheme.is_normalized());

let mut scheme = UnregisteredScheme::try_from("MyScHeMe").unwrap();
assert!(!scheme.is_normalized());
scheme.normalize();
assert!(scheme.is_normalized());

pub fn normalize(&mut self)

Normalizes the scheme so that it is all lowercase.

Examples

use std::convert::TryFrom;

use uriparse::UnregisteredScheme;

let mut scheme = UnregisteredScheme::try_from("myscheme").unwrap();
scheme.normalize();
assert_eq!(scheme, "myscheme");

let mut scheme = UnregisteredScheme::try_from("MyScHeMe").unwrap();
scheme.normalize();
assert_eq!(scheme, "myscheme");

Trait Implementations

impl AsRef<[u8]> for UnregisteredScheme<'_>

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for UnregisteredScheme<'_>

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl<'scheme> Clone for UnregisteredScheme<'scheme>

fn clone(&self) -> UnregisteredScheme<'scheme>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'scheme> Debug for UnregisteredScheme<'scheme>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for UnregisteredScheme<'_>

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'scheme> From<UnregisteredScheme<'scheme>> for String

fn from(value: UnregisteredScheme<'scheme>) -> Self

Converts to this type from the input type.

impl Hash for UnregisteredScheme<'_>

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq<&'a [u8]> for UnregisteredScheme<'_>

fn eq(&self, other: &&'a [u8]) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialEq<&'a str> for UnregisteredScheme<'_>

fn eq(&self, other: &&'a str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<[u8]> for UnregisteredScheme<'_>

fn eq(&self, other: &[u8]) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a, 'scheme> PartialEq<UnregisteredScheme<'scheme>> for &'a [u8]

fn eq(&self, other: &UnregisteredScheme<'scheme>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a, 'scheme> PartialEq<UnregisteredScheme<'scheme>> for &'a str

fn eq(&self, other: &UnregisteredScheme<'scheme>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'scheme> PartialEq<UnregisteredScheme<'scheme>> for [u8]

fn eq(&self, other: &UnregisteredScheme<'scheme>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'scheme> PartialEq<UnregisteredScheme<'scheme>> for str

fn eq(&self, other: &UnregisteredScheme<'scheme>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for UnregisteredScheme<'_>

fn eq(&self, other: &str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for UnregisteredScheme<'_>

fn eq(&self, other: &UnregisteredScheme<'_>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'scheme> TryFrom<&'scheme [u8]> for UnregisteredScheme<'scheme>

type Error = UnregisteredSchemeError

The type returned in the event of a conversion error.

fn try_from(value: &'scheme [u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl<'scheme> TryFrom<&'scheme str> for UnregisteredScheme<'scheme>

type Error = UnregisteredSchemeError

The type returned in the event of a conversion error.

fn try_from(value: &'scheme str) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for UnregisteredScheme<'_>