Struct OwnedPath 

pub struct OwnedPath<State: PathState> { /* private fields */ }

Available on Linux only.

Implementations

impl OwnedPath<Abs>

pub fn root() -> OwnedPath<Abs>

pub fn home() -> Option<OwnedPath<Abs>>

pub fn cwd() -> Option<OwnedPath<Abs>>

impl<S: PathState> OwnedPath<S>

pub unsafe fn from_unchecked<O: Into<OsString>>(inner: O) -> Self

pub fn as_path(&self) -> &Path<S>

pub fn push<P: AsRef<Path<Rel>>>(&mut self, other: P)

pub fn pop(&mut self) -> Option<OwnedPath<Rel>>

impl OwnedPath<Rel>

pub fn dot() -> OwnedPath<Rel>

pub fn resolve_root(self) -> OwnedPath<Abs>

Methods from Deref<Target = Path<S>>

pub fn display<'a>(&'a self) -> DisplayPath<'a, S>

pub fn len(&self) -> NonZero<usize>

pub fn as_os_str(&self) -> &OsStr

pub fn as_os_str_no_lead(&self) -> &OsStr

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

pub fn basename(&self) -> &OsStr

Returns the basename of this path (the OsStr following the last / in the path). This OsStr won’t contain any instances of /.

See parent() for more info.

pub fn parent(&self) -> &Self

Returns the parent directory of this path (lexically speaking). The result is a Path with basename and the preceding slash removed, such that the following holds for any path.

let owned = OwnedPath::<Abs>::from("/my/path");
let path: &Path<Abs> = &owned;
let new_path = path.parent().join(Path::new(path.basename()));
assert_eq!(path, new_path);

Because this method is the counterpart of basename and basename won’t contain any /, the behavior when calling these methods on "/" is as follows:

assert_eq!(Path::root().basename(), "");
assert_eq!(Path::root().parent(), Path::root());

This behavior is also consistent with Unix defaults: the .. entry in the root directory refers to the root itself.

pub fn join<P: AsRef<Path<Rel>>>(&self, other: P) -> OwnedPath<S>

pub fn relative_to(&self, other: &Self) -> Option<&Path<Rel>>

pub fn components<'a>(&'a self) -> Components<'a, S>

Creates an Iterator over the components of a Path. This iterator produces Path<Rel>s representing each /-separated string in the Path, from left to right.

pub fn ancestors<'a>(&'a self) -> Ancestors<'a, S>

Creates an Iterator over the ancestors of a Path. This iterator produces Path<S>s representing each directory in the Path ordered with descending depth and ending with the Path itself.

Trait Implementations

impl<S: PathState> AsRef<Path<S>> for OwnedPath<S>

fn as_ref(&self) -> &Path<S>

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

impl<S: PathState> Borrow<Path<S>> for OwnedPath<S>

fn borrow(&self) -> &Path<S>

Immutably borrows from an owned value.

impl<S: PathState> Clone for OwnedPath<S>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: PathState> Debug for OwnedPath<S>

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

Formats the value using the given formatter.

impl<S: PathState> Deref for OwnedPath<S>

type Target = Path<S>

The resulting type after dereferencing.

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

Dereferences the value.

impl<S: PathState> From<&Path<S>> for OwnedPath<S>

fn from(value: &Path<S>) -> Self

Converts to this type from the input type.

impl<S: PathState> From<OwnedPath<S>> for CString

fn from(value: OwnedPath<S>) -> Self

Converts to this type from the input type.

impl<T: AsRef<OsStr>, S: PathState> From<T> for OwnedPath<S>

fn from(value: T) -> Self

Converts to this type from the input type.

impl<S: PathState> Ord for OwnedPath<S>

fn cmp(&self, other: &Self) -> 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<S: PathState> PartialEq<OwnedPath<S>> for Path<S>

fn eq(&self, other: &OwnedPath<S>) -> 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<S: PathState> PartialEq<Path<S>> for OwnedPath<S>

fn eq(&self, other: &Path<S>) -> 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<S: PathState> PartialEq for OwnedPath<S>

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<S: PathState> PartialOrd<OwnedPath<S>> for Path<S>

fn partial_cmp(&self, other: &OwnedPath<S>) -> 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<S: PathState> PartialOrd<Path<S>> for OwnedPath<S>

fn partial_cmp(&self, other: &Path<S>) -> 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<S: PathState> PartialOrd for OwnedPath<S>

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<S: PathState> Eq for OwnedPath<S>