[−][src]Struct mail::IRI
A minimal IRI (International Resource Identifier) implementation which just parses the scheme but no scheme specific part (and neither fragments wrt. those definitions in which fragments are not scheme specific parts).
This implementation does not perform any form of normalization or other IRI specific aspects, it's basically just a String split into two parts.
Additionally this implementations requires all URI to be valid utf8.
Example
let uri = IRI::new("file:/random/logo.png").unwrap(); assert_eq!(uri.scheme(), "file"); assert_eq!(uri.tail(), "/random/logo.png");
Methods
impl IRI
[src]
pub fn from_parts(scheme: &str, tail: &str) -> Result<IRI, InvalidIRIScheme>
[src]
Create a new IRI from a scheme part and a tail part.
This will convert the scheme part into lower case before using it.
pub fn new<I>(iri: I) -> Result<IRI, InvalidIRIScheme> where
I: Into<String>,
[src]
I: Into<String>,
crates a new a IRI
- this determines the first occurrence of
:
to split the input into scheme and tail - it validates that the scheme name is RFC 3986
compatible, i.e. is ascii, starting with a letter followed by alpha numeric characters
(or
"+"
,"-"
,"."
). - converts the scheme part to lower case
pub fn with_tail(&self, new_tail: &str) -> IRI
[src]
Creates a new IRI with the same schema but a different tail.
pub fn scheme(&self) -> &str
[src]
The scheme part of the uri excluding the :
seperator.
The scheme is guaranteed to be lower case.
Example
let uri = IRI::new("file:///opt/share/logo.png").unwrap(); assert_eq!(uri.scheme(), "file");
pub fn tail(&self) -> &str
[src]
the scheme specific part of the uri
Example
let uri = IRI::new("file:///opt/share/logo.png").unwrap(); assert_eq!(uri.scheme(), "file");
pub fn as_str(&self) -> &str
[src]
returns the underlying string representation
Note that it does not implement Display even through
it implements as_str
and Into<String>
as displaying
a IRI is more complex then just displaying a string (mainly due to
bidirectional IRI's).
Trait Implementations
impl FromStr for IRI
[src]
type Err = InvalidIRIScheme
The associated error which can be returned from parsing.
fn from_str(inp: &str) -> Result<IRI, <IRI as FromStr>::Err>
[src]
impl Clone for IRI
[src]
fn clone(&self) -> IRI
[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Hash for IRI
[src]
fn hash<__H>(&self, state: &mut __H) where
__H: Hasher,
[src]
__H: Hasher,
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
Feeds a slice of this type into the given [Hasher
]. Read more
impl PartialOrd<IRI> for IRI
[src]
fn partial_cmp(&self, other: &IRI) -> Option<Ordering>
[src]
fn lt(&self, other: &IRI) -> bool
[src]
fn le(&self, other: &IRI) -> bool
[src]
fn gt(&self, other: &IRI) -> bool
[src]
fn ge(&self, other: &IRI) -> bool
[src]
impl Ord for IRI
[src]
fn cmp(&self, other: &IRI) -> Ordering
[src]
fn max(self, other: Self) -> Self
1.21.0[src]
Compares and returns the maximum of two values. Read more
fn min(self, other: Self) -> Self
1.21.0[src]
Compares and returns the minimum of two values. Read more
impl Serialize for IRI
[src]
fn serialize<S>(
&self,
serializer: S
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error> where
S: Serializer,
[src]
&self,
serializer: S
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error> where
S: Serializer,
impl Into<String> for IRI
[src]
impl Eq for IRI
[src]
impl<'de> Deserialize<'de> for IRI
[src]
fn deserialize<D>(
deserializer: D
) -> Result<IRI, <D as Deserializer<'de>>::Error> where
D: Deserializer<'de>,
[src]
deserializer: D
) -> Result<IRI, <D as Deserializer<'de>>::Error> where
D: Deserializer<'de>,
impl PartialEq<IRI> for IRI
[src]
impl Debug for IRI
[src]
impl PathRebaseable for IRI
[src]
fn rebase_to_include_base_dir<impl AsRef>(
&mut self,
base_dir: impl AsRef
) -> Result<(), UnsupportedPathError> where
impl AsRef: AsRef<Path>,
[src]
&mut self,
base_dir: impl AsRef
) -> Result<(), UnsupportedPathError> where
impl AsRef
fn rebase_to_exclude_base_dir<impl AsRef>(
&mut self,
base_dir: impl AsRef
) -> Result<(), UnsupportedPathError> where
impl AsRef: AsRef<Path>,
[src]
&mut self,
base_dir: impl AsRef
) -> Result<(), UnsupportedPathError> where
impl AsRef
Auto Trait Implementations
Blanket Implementations
impl<T> From for T
[src]
impl<T, U> Into for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
impl<T, U> TryFrom for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = !
try_from
)The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T> Borrow for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
try_from
)The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> DeserializeOwned for T where
T: Deserialize<'de>,
[src]
T: Deserialize<'de>,
impl<F, T> HeaderTryInto for F where
T: HeaderTryFrom<F>,
[src]
T: HeaderTryFrom<F>,