Struct Path 

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

Percent-encoded URL path.

Implementations

impl Path

pub const fn as_str(&self) -> &str

Returns the component as a string slice.

impl Path

pub fn new(src: &str) -> Result<&Path, InvalidUrl>

Strictly validates a path: *( pchar / "/" ).

pub fn from_static(src: &'static str) -> &'static Path

Converts a static string to a path.

Panics

Panics if the path is not valid.

pub fn is_empty(&self) -> bool

Returns true if the path is empty.

pub fn is_absolute(&self) -> bool

Returns true if the path starts with /.

pub fn decode(&self) -> Cow<'_, str>

Returns the decoded path.

use urly::Path;

assert_eq!(Path::from_static("/a%20b/c%2Fd").decode(), "/a b/c/d");

pub fn decode_safe(&self) -> Cow<'_, str>

Returns the decoded path, keeping %2F and %25 encoded, so the result can still be split into segments.

use urly::Path;

assert_eq!(Path::from_static("/a%20b/c%2Fd").decode_safe(), "/a b/c%2Fd");

pub fn segments(&self) -> Segments<'_>

Returns an iterator over the percent-encoded segments.

use urly::Path;

let segments: Vec<_> = Path::from_static("/a/b%20c/").segments().collect();
assert_eq!(segments, ["a", "b%20c", ""]);
assert_eq!(Path::from_static("").segments().count(), 0);

pub fn file_name(&self) -> Option<&str>

Returns the last segment, unless it is empty, . or ...

use urly::Path;

assert_eq!(Path::from_static("/a/file.tar.gz").file_name(), Some("file.tar.gz"));
assert_eq!(Path::from_static("/a/").file_name(), None);

pub fn file_stem(&self) -> Option<&str>

Returns the file name without its last extension.

use urly::Path;

assert_eq!(Path::from_static("/file.tar.gz").file_stem(), Some("file.tar"));
assert_eq!(Path::from_static("/.hidden").file_stem(), Some(".hidden"));

pub fn extension(&self) -> Option<&str>

Returns the last extension of the file name, without the dot.

use urly::Path;

assert_eq!(Path::from_static("/file.tar.gz").extension(), Some("gz"));
assert_eq!(Path::from_static("/.hidden").extension(), None);

pub fn extensions(&self) -> Option<&str>

Returns all extensions of the file name, without the leading dot.

use urly::Path;

assert_eq!(Path::from_static("/file.tar.gz").extensions(), Some("tar.gz"));
assert_eq!(Path::from_static("/file").extensions(), None);

Trait Implementations

impl AsRef<str> for Path

fn as_ref(&self) -> &str

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

impl Debug for Path

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

Formats the value using the given formatter.

impl Display for Path

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

Formats the value using the given formatter.

impl Eq for Path

impl Hash for Path

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

Feeds this value into the given Hasher.

impl Ord for Path

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

This method returns an Ordering between self and other.

impl PartialEq for Path

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<&str> for Path

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<Path> for str

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<Path> for &str

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<str> for Path

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Path

fn partial_cmp(&self, other: &Path) -> 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<'a> TryFrom<&'a str> for &'a Path

type Error = InvalidUrl

The type returned in the event of a conversion error.

fn try_from(s: &'a str) -> Result<Self, Self::Error>

Performs the conversion.