Struct Path

pub struct Path<'a> { /* private fields */ }

Path provides a copy-on-write-style path that is built around UTF8 strings.

Implementations

impl<'a> Path<'a>

pub const fn new(s: &'a str) -> Self

Create a new path that borrows the provided string.

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

Convert the path into an owned path.

pub fn into_std(&self) -> &Path

Convert the path into a std::path::PathBuf.

pub fn as_str(&self) -> &str

Convert the path to a str.

pub fn is_dir(&self) -> bool

Is the path a directory?

pub fn basename(&self) -> Path<'_>

Compute the basename of the path. This is guaraneed to be a non-empty path component (falling back to “.” for paths that end with “/”).

pub fn dirname(&self) -> Path<'_>

Compute the dirname of the path. This is guaranteed to be a non-empty path component (falling back to “.” or “/” for single-component paths).

pub fn exists(&self) -> bool

True if the path exists.

pub fn has_root(&self) -> bool

True if the path begins with some number of slashes, other than the POSIX-exception of //.

pub fn has_app_defined(&self) -> bool

True if the path begins with //, but not ///.

pub fn is_abs(&self) -> bool

True if the path is absolute.

pub fn is_normal(&self) -> bool

True if the path contains no “.” components; and, is absolute and has no “..” components, or is relative and has all “..” components at the start.

pub fn join<'b, 'c>(&self, with: impl Into<Path<'b>>) -> Path<'c>

where 'a: 'c, 'b: 'c,

Join to this path another path. Follows standard path rules where if the joined-with path is absolute, the first path is discarded.

pub fn strip_prefix<'b>(&self, prefix: impl Into<Path<'b>>) -> Option<Path<'_>>

Strip a prefix from the path. The prefix and path are allowed to be non-normal and will have “.” components dropped from consideration.

pub fn split(&self) -> (Path<'_>, Path<'_>)

Split the path into basename and dirname components.

pub fn components(&self) -> impl Iterator<Item = Component<'_>>

Return an iterator ovre the path components. A path with a basename of “.” will always end with Component::CurDir.

pub fn cwd() -> Option<Path<'a>>

Return the current working directory, if it can be fetched and converted to unicode without error.

Trait Implementations

impl<'a> AsRef<OsStr> for Path<'a>

fn as_ref(&self) -> &OsStr

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

impl<'a> AsRef<Path> for Path<'a>

fn as_ref(&self) -> &Path

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

impl<'a> Borrow<Path> for Path<'a>

fn borrow(&self) -> &Path

Immutably borrows from an owned value.

impl<'a> Clone for Path<'a>

fn clone(&self) -> Path<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Path<'a>

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

Formats the value using the given formatter.

impl<'a> Display for Path<'a>

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

Formats the value using the given formatter.

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

fn from(path: &'a Path<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<&'a String> for Path<'a>

fn from(s: &'a String) -> Self

Converts to this type from the input type.

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

fn from(s: &'a str) -> Self

Converts to this type from the input type.

impl<'a> From<Path<'a>> for PathBuf

fn from(path: Path<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Path<'a>> for String

fn from(path: Path<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<String> for Path<'a>

fn from(s: String) -> Self

Converts to this type from the input type.

impl<'a> Hash for Path<'a>

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

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> Ord for Path<'a>

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'a> PartialEq for Path<'a>

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

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

type Error = Utf8Error

The type returned in the event of a conversion error.

fn try_from(p: &'a Path) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<OsString> for Path<'a>

type Error = Utf8Error

The type returned in the event of a conversion error.

fn try_from(p: OsString) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<PathBuf> for Path<'a>

type Error = Utf8Error

The type returned in the event of a conversion error.

fn try_from(p: PathBuf) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> Eq for Path<'a>

impl<'a> StructuralPartialEq for Path<'a>