1.0.0[−][src]Enum std::path::Component  
A single component of a path.
A Component roughly corresponds to a substring between path separators
(/ or \).
This enum is created by iterating over Components, which in turn is
created by the components method on Path.
Examples
use std::path::{Component, Path}; let path = Path::new("/tmp/foo/bar.txt"); let components = path.components().collect::<Vec<_>>(); assert_eq!(&components, &[ Component::RootDir, Component::Normal("tmp".as_ref()), Component::Normal("foo".as_ref()), Component::Normal("bar.txt".as_ref()), ]);Run
Variants
Prefix(PrefixComponent<'a>)A Windows path prefix, e.g. C: or \\server\share.
There is a large variety of prefix types, see Prefix's documentation
for more.
Does not occur on Unix.
RootDirThe root directory component, appears after any prefix and before anything else.
It represents a separator that designates that a path starts from root.
CurDirA reference to the current directory, i.e. ..
ParentDirA reference to the parent directory, i.e. ...
Normal(&'a OsStr)A normal component, e.g. a and b in a/b.
This variant is the most common one, it represents references to files or directories.
Methods
impl<'a> Component<'a>[src] 
impl<'a> Component<'a>Trait Implementations
impl<'a> Copy for Component<'a>[src] 
impl<'a> Copy for Component<'a>impl<'a> Clone for Component<'a>[src] 
impl<'a> Clone for Component<'a>fn clone(&self) -> Component<'a>[src] 
fn clone(&self) -> Component<'a>Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)[src] 
fn clone_from(&mut self, source: &Self)Performs copy-assignment from source. Read more
impl<'a> PartialEq for Component<'a>[src] 
impl<'a> PartialEq for Component<'a>fn eq(&self, other: &Component<'a>) -> bool[src] 
fn eq(&self, other: &Component<'a>) -> boolThis method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &Component<'a>) -> bool[src] 
fn ne(&self, other: &Component<'a>) -> boolThis method tests for !=.
impl<'a> Eq for Component<'a>[src] 
impl<'a> Eq for Component<'a>impl<'a> PartialOrd for Component<'a>[src] 
impl<'a> PartialOrd for Component<'a>fn partial_cmp(&self, other: &Component<'a>) -> Option<Ordering>[src] 
fn partial_cmp(&self, other: &Component<'a>) -> Option<Ordering>This method returns an ordering between self and other values if one exists. Read more
fn lt(&self, other: &Component<'a>) -> bool[src] 
fn lt(&self, other: &Component<'a>) -> boolThis method tests less than (for self and other) and is used by the < operator. Read more
fn le(&self, other: &Component<'a>) -> bool[src] 
fn le(&self, other: &Component<'a>) -> boolThis method tests less than or equal to (for self and other) and is used by the <= operator. Read more
fn gt(&self, other: &Component<'a>) -> bool[src] 
fn gt(&self, other: &Component<'a>) -> boolThis method tests greater than (for self and other) and is used by the > operator. Read more
fn ge(&self, other: &Component<'a>) -> bool[src] 
fn ge(&self, other: &Component<'a>) -> boolThis method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
impl<'a> Ord for Component<'a>[src] 
impl<'a> Ord for Component<'a>fn cmp(&self, other: &Component<'a>) -> Ordering[src] 
fn cmp(&self, other: &Component<'a>) -> OrderingThis method returns an Ordering between self and other. Read more
fn max(self, other: Self) -> Self1.21.0[src] 
fn max(self, other: Self) -> SelfCompares and returns the maximum of two values. Read more
fn min(self, other: Self) -> Self1.21.0[src] 
fn min(self, other: Self) -> SelfCompares and returns the minimum of two values. Read more
impl<'a> Hash for Component<'a>[src] 
impl<'a> Hash for Component<'a>fn hash<__H: Hasher>(&self, state: &mut __H)[src] 
fn hash<__H: Hasher>(&self, state: &mut __H)Feeds this value into the given [Hasher]. Read more
fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 1.3.0[src] 
fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, Feeds a slice of this type into the given [Hasher]. Read more
impl<'a> Debug for Component<'a>[src] 
impl<'a> Debug for Component<'a>fn fmt(&self, f: &mut Formatter) -> Result[src] 
fn fmt(&self, f: &mut Formatter) -> ResultFormats the value using the given formatter. Read more
impl<'a> AsRef<OsStr> for Component<'a>[src] 
impl<'a> AsRef<OsStr> for Component<'a>impl<'a> AsRef<Path> for Component<'a>1.25.0[src] 
impl<'a> AsRef<Path> for Component<'a>Auto Trait Implementations
Blanket Implementations
impl<T> From for T[src] 
impl<T> From for Timpl<T, U> TryFrom for T where
    T: From<U>, [src] 
impl<T, U> TryFrom for T where
    T: From<U>, type Error = !
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src] 
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>Performs the conversion.
impl<T, U> TryInto for T where
    U: TryFrom<T>, [src] 
impl<T, U> TryInto for T where
    U: TryFrom<T>, type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src] 
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>Performs the conversion.
impl<T, U> Into for T where
    U: From<T>, [src] 
impl<T, U> Into for T where
    U: From<T>, impl<T> Borrow for T where
    T: ?Sized, [src] 
impl<T> Borrow for T where
    T: ?Sized, ⓘImportant traits for &'a mut Ifn borrow(&self) -> &T[src] 
fn borrow(&self) -> &TImmutably borrows from an owned value. Read more
impl<T> BorrowMut for T where
    T: ?Sized, [src] 
impl<T> BorrowMut for T where
    T: ?Sized, ⓘImportant traits for &'a mut Ifn borrow_mut(&mut self) -> &mut T[src] 
fn borrow_mut(&mut self) -> &mut TMutably borrows from an owned value. Read more
impl<T> Any for T where
    T: 'static + ?Sized, [src] 
impl<T> Any for T where
    T: 'static + ?Sized, fn get_type_id(&self) -> TypeId[src] 
fn get_type_id(&self) -> TypeId🔬 This is a nightly-only experimental API.  (get_type_id #27745)
this method will likely be replaced by an associated static
Gets the TypeId of self. Read more
impl<T> ToOwned for T where
    T: Clone, [src] 
impl<T> ToOwned for T where
    T: Clone, type Owned = T
fn to_owned(&self) -> T[src] 
fn to_owned(&self) -> TCreates owned data from borrowed data, usually by cloning. Read more
fn clone_into(&self, target: &mut T)[src] 
fn clone_into(&self, target: &mut T)🔬 This is a nightly-only experimental API.  (toowned_clone_into #41263)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more