Struct RelPath 

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

A file system path that is guaranteed to be relative and normalized.

This type can be used to represent paths in a uniform way, regardless of whether they refer to Windows or POSIX file systems, and regardless of the host platform.

Internally, paths are stored in POSIX (‘/’-delimited) format, but they can be displayed in either POSIX or Windows format.

Relative paths are also guaranteed to be valid unicode.

Implementations

impl RelPath

pub fn empty() -> &'static Self

Creates an empty RelPath.

pub fn new<'a>(path: &'a Path, path_style: PathStyle) -> Result<Cow<'a, Self>>

Converts a path with a given style into a RelPath.

Returns an error if the path is absolute, or is not valid unicode.

This method will normalize the path by removing . components, processing .. components, and removing trailing separators. It does not allocate unless it’s necessary to reformat the path.

pub fn unix<S: AsRef<Path> + ?Sized>(path: &S) -> Result<&Self>

Converts a path that is already normalized and uses ‘/’ separators into a RelPath .

Returns an error if the path is not already in the correct format.

pub fn is_empty(&self) -> bool

pub fn components(&self) -> RelPathComponents<'_>

pub fn ancestors(&self) -> RelPathAncestors<'_>

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

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

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

pub fn parent(&self) -> Option<&Self>

pub fn starts_with(&self, other: &Self) -> bool

pub fn ends_with(&self, other: &Self) -> bool

pub fn strip_prefix<'a>(&'a self, other: &Self) -> Result<&'a Self>

pub fn len(&self) -> usize

pub fn last_n_components(&self, count: usize) -> Option<&Self>

pub fn join(&self, other: &Self) -> Arc<Self>

pub fn to_rel_path_buf(&self) -> RelPathBuf

pub fn into_arc(&self) -> Arc<Self>

pub fn to_proto(&self) -> String

Convert the path into the wire representation.

pub fn from_proto(path: &str) -> Result<Arc<Self>>

Load the path from its wire representation.

pub fn display(&self, style: PathStyle) -> Cow<'_, str>

Convert the path into a string with the given path style.

Whenever a path is presented to the user, it should be converted to a string via this method.

pub fn as_unix_str(&self) -> &str

Get the internal unix-style representation of the path.

This should not be shown to the user.

pub fn as_std_path(&self) -> &Path

Interprets the path as a std::path::Path, suitable for file system calls.

This is guaranteed to be a valid path regardless of the host platform, because the / is accepted as a path separator on windows.

This should not be shown to the user.

Trait Implementations

impl AsRef<RelPath> for RelPathBuf

fn as_ref(&self) -> &RelPath

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

impl Borrow<RelPath> for RelPathBuf

fn borrow(&self) -> &RelPath

Immutably borrows from an owned value.

impl Debug for RelPath

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

Formats the value using the given formatter.

impl From<&RelPath> for Arc<RelPath>

fn from(rel_path: &RelPath) -> Self

Converts to this type from the input type.

impl<'a> From<&'a RelPath> for Cow<'a, RelPath>

fn from(value: &'a RelPath) -> Self

Converts to this type from the input type.

impl Hash for RelPath

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

Feeds this value into the given Hasher.

impl Ord for RelPath

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

This method returns an Ordering between self and other.

impl PartialEq<str> for RelPath

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

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

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 Serialize for RelPath

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToOwned for RelPath

type Owned = RelPathBuf

The resulting type after obtaining ownership.

fn to_owned(&self) -> Self::Owned

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 Eq for RelPath

impl StructuralPartialEq for RelPath