1.0.0[−][src]Enum std::path::Prefix
Windows path prefixes, e.g., C: or \\server\share.
Windows uses a variety of path prefix styles, including references to drive
volumes (like C:), network shared folders (like \\server\share), and
others. In addition, some path prefixes are "verbatim" (i.e., prefixed with
\\?\), in which case / is not treated as a separator and essentially
no normalization is performed.
Examples
use std::path::{Component, Path, Prefix}; use std::path::Prefix::*; use std::ffi::OsStr; fn get_path_prefix(s: &str) -> Prefix { let path = Path::new(s); match path.components().next().unwrap() { Component::Prefix(prefix_component) => prefix_component.kind(), _ => panic!(), } } assert_eq!(Verbatim(OsStr::new("pictures")), get_path_prefix(r"\\?\pictures\kittens")); assert_eq!(VerbatimUNC(OsStr::new("server"), OsStr::new("share")), get_path_prefix(r"\\?\UNC\server\share")); assert_eq!(VerbatimDisk(b'C'), get_path_prefix(r"\\?\c:\")); assert_eq!(DeviceNS(OsStr::new("BrainInterface")), get_path_prefix(r"\\.\BrainInterface")); assert_eq!(UNC(OsStr::new("server"), OsStr::new("share")), get_path_prefix(r"\\server\share")); assert_eq!(Disk(b'C'), get_path_prefix(r"C:\Users\Rust\Pictures\Ferris"));Run
Variants
Verbatim(&'a OsStr)Verbatim prefix, e.g., \\?\cat_pics.
Verbatim prefixes consist of \\?\ immediately followed by the given
component.
Verbatim prefix using Windows' Uniform Naming Convention,
e.g., \\?\UNC\server\share.
Verbatim UNC prefixes consist of \\?\UNC\ immediately followed by the
server's hostname and a share name.
VerbatimDisk(u8)Verbatim disk prefix, e.g., \\?\C:\.
Verbatim disk prefixes consist of \\?\ immediately followed by the
drive letter and :\.
DeviceNS(&'a OsStr)Device namespace prefix, e.g., \\.\COM42.
Device namespace prefixes consist of \\.\ immediately followed by the
device name.
Prefix using Windows' Uniform Naming Convention, e.g.
\\server\share.
UNC prefixes consist of the server's hostname and a share name.
Disk(u8)Prefix C: for the given disk drive.
Methods
impl<'a> Prefix<'a>[src]
pub fn is_verbatim(&self) -> bool[src]
Determines if the prefix is verbatim, i.e., begins with \\?\.
Examples
use std::path::Prefix::*; use std::ffi::OsStr; assert!(Verbatim(OsStr::new("pictures")).is_verbatim()); assert!(VerbatimUNC(OsStr::new("server"), OsStr::new("share")).is_verbatim()); assert!(VerbatimDisk(b'C').is_verbatim()); assert!(!DeviceNS(OsStr::new("BrainInterface")).is_verbatim()); assert!(!UNC(OsStr::new("server"), OsStr::new("share")).is_verbatim()); assert!(!Disk(b'C').is_verbatim());Run
Trait Implementations
impl<'a> Clone for Prefix<'a>[src]
impl<'a> Copy for Prefix<'a>[src]
impl<'a> Debug for Prefix<'a>[src]
impl<'a> Eq for Prefix<'a>[src]
impl<'a> Hash for Prefix<'a>[src]
fn hash<__H: Hasher>(&self, state: &mut __H)[src]
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher, 1.3.0[src]
H: Hasher,
impl<'a> Ord for Prefix<'a>[src]
fn cmp(&self, other: &Prefix<'a>) -> Ordering[src]
#[must_use]fn max(self, other: Self) -> Self1.21.0[src]
#[must_use]fn min(self, other: Self) -> Self1.21.0[src]
#[must_use]fn clamp(self, min: Self, max: Self) -> Self[src]
impl<'a> PartialEq<Prefix<'a>> for Prefix<'a>[src]
impl<'a> PartialOrd<Prefix<'a>> for Prefix<'a>[src]
fn partial_cmp(&self, other: &Prefix<'a>) -> Option<Ordering>[src]
fn lt(&self, other: &Prefix<'a>) -> bool[src]
fn le(&self, other: &Prefix<'a>) -> bool[src]
fn gt(&self, other: &Prefix<'a>) -> bool[src]
fn ge(&self, other: &Prefix<'a>) -> bool[src]
impl<'a> StructuralEq for Prefix<'a>[src]
impl<'a> StructuralPartialEq for Prefix<'a>[src]
Auto Trait Implementations
impl<'a> RefUnwindSafe for Prefix<'a>
impl<'a> Send for Prefix<'a>
impl<'a> Sync for Prefix<'a>
impl<'a> Unpin for Prefix<'a>
impl<'a> UnwindSafe for Prefix<'a>
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized, [src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized, [src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized, [src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T[src]
impl<T> From<T> for T[src]
impl<T, U> Into<U> for T where
U: From<T>, [src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone, [src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T[src]
fn clone_into(&self, target: &mut T)[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>, [src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>, [src]
U: TryFrom<T>,