Struct Segment

pub struct Segment(/* private fields */);

IRI path segment.

Implementations

impl Segment

pub fn new<T: ?Sized + AsRef<[u8]>>( input: &T, ) -> Result<&Self, InvalidSegment<&T>>

Creates a new URI path segment by parsing the input value

pub const unsafe fn new_unchecked(input: &[u8]) -> &Self

Creates a new URI path segment from the input value without validation.

Safety

The input data must be a valid URI path segment.

pub fn validate(input: impl Iterator<Item = u8>) -> bool

Checks that the input iterator produces a valid URI path segment

impl Segment

pub const EMPTY: &'static Self

impl Segment

pub fn as_bytes(&self) -> &[u8]

impl Segment

pub fn as_str(&self) -> &str

impl Segment

pub const CURRENT: &'static Self

pub const PARENT: &'static Self

pub fn as_pct_str(&self) -> &PctStr

Returns the segment as a percent-encoded string slice.

pub fn looks_like_scheme(&self) -> bool

Checks if this segments looks like a scheme part.

Returns true is of the form prefix:suffix where prefix is a valid scheme, of false otherwise.

Methods from Deref<Target = PctStr>

pub fn len(&self) -> usize

Length of the decoded string (character count).

Computed in linear time. This is different from the byte length, which can be retrieved using value.as_bytes().len().

pub fn is_empty(&self) -> bool

Checks if the string is empty.

pub fn as_bytes(&self) -> &[u8]

Returns the underlying percent-encoding bytes.

pub fn as_str(&self) -> &str

Get the underlying percent-encoded string slice.

pub fn chars(&self) -> Chars<'_>

Iterate over the encoded characters of the string.

pub fn bytes(&self) -> Bytes<'_>

Iterate over the encoded bytes of the string.

pub fn decode(&self) -> String

Decoding.

Return the string with the percent-encoded characters decoded.

Trait Implementations

impl AsRef<[u8]> for Segment

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

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

impl AsRef<Segment> for Segment

fn as_ref(&self) -> &Segment

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

impl AsRef<Segment> for SegmentBuf

fn as_ref(&self) -> &Segment

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

impl AsRef<str> for Segment

fn as_ref(&self) -> &str

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

impl Borrow<[u8]> for Segment

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

Immutably borrows from an owned value.

impl Borrow<Segment> for SegmentBuf

fn borrow(&self) -> &Segment

Immutably borrows from an owned value.

impl Debug for Segment

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

Formats the value using the given formatter.

impl Deref for Segment

type Target = PctStr

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Display for Segment

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

Formats the value using the given formatter.

impl<'a> From<&'a Segment> for &'a [u8]

fn from(value: &'a Segment) -> &'a [u8]

Converts to this type from the input type.

impl<'a> From<&'a Segment> for &'a str

fn from(value: &'a Segment) -> &'a str

Converts to this type from the input type.

impl Hash for Segment

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

Feeds this value into the given Hasher.

impl Ord for Segment

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

impl<'a> PartialEq<&'a Segment> for SegmentBuf

fn eq(&self, other: &&'a Segment) -> 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<Segment> for SegmentBuf

fn eq(&self, other: &Segment) -> 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 Segment

fn eq(&self, other: &Self) -> 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> PartialOrd<&'a Segment> for SegmentBuf

fn partial_cmp(&self, other: &&'a Segment) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Segment> for SegmentBuf

fn partial_cmp(&self, other: &Segment) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd for Segment

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl ToOwned for Segment

type Owned = SegmentBuf

The resulting type after obtaining ownership.

fn to_owned(&self) -> SegmentBuf

Creates owned data from borrowed data, usually by cloning.

fn clone_into(&self, target: &mut Self::Owned)

Uses borrowed data to replace owned data, usually by cloning.

impl<'a> TryFrom<&'a [u8]> for &'a Segment

type Error = InvalidSegment<&'a [u8]>

The type returned in the event of a conversion error.

fn try_from(input: &'a [u8]) -> Result<&'a Segment, InvalidSegment<&'a [u8]>>

Performs the conversion.

impl<'a> TryFrom<&'a str> for &'a Segment

type Error = InvalidSegment<&'a str>

The type returned in the event of a conversion error.

fn try_from(input: &'a str) -> Result<&'a Segment, InvalidSegment<&'a str>>

Performs the conversion.

impl Eq for Segment