Struct typed_path::Utf8Path
source · #[repr(transparent)]pub struct Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,{ /* private fields */ }
Expand description
A slice of a path (akin to str
).
This type supports a number of operations for inspecting a path, including
breaking the path into its components (separated by /
on Unix and by either
/
or \
on Windows), extracting the file name, determining whether the path
is absolute, and so on.
This is an unsized type, meaning that it must always be used behind a
pointer like &
or Box
. For an owned version of this type,
see Utf8PathBuf
.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding,
// but all encodings work on all operating systems, providing the
// ability to parse and operate on paths independently of the
// compiled platform
let path = Utf8Path::<Utf8UnixEncoding>::new("./foo/bar.txt");
let parent = path.parent();
assert_eq!(parent, Some(Utf8Path::new("./foo")));
let file_stem = path.file_stem();
assert_eq!(file_stem, Some("bar"));
let extension = path.extension();
assert_eq!(extension, Some("txt"));
In addition to explicitly using Utf8Encoding
s, you can also
leverage aliases available from the crate to work with paths:
use typed_path::{Utf8UnixPath, Utf8WindowsPath};
// Same as Utf8Path<Utf8UnixEncoding>
let path = Utf8UnixPath::new("/foo/bar.txt");
// Same as Utf8Path<Utf8WindowsEncoding>
let path = Utf8WindowsPath::new(r"C:\foo\bar.txt");
To mirror the design of Rust’s standard library, you can access
the path associated with the compiled rust platform using Utf8NativePath
,
which itself is an alias to one of the other choices:
use typed_path::Utf8NativePath;
// On Unix, this would be Utf8UnixPath aka Utf8Path<Utf8UnixEncoding>
// On Windows, this would be Utf8WindowsPath aka Utf8Path<Utf8WindowsEncoding>
let path = Utf8NativePath::new("/foo/bar.txt");
Implementations§
source§impl<T> Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
sourcepub fn new<S: AsRef<str> + ?Sized>(s: &S) -> &Self
pub fn new<S: AsRef<str> + ?Sized>(s: &S) -> &Self
Directly wraps a str slice as a Utf8Path
slice.
This is a cost-free conversion.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
Utf8Path::<Utf8UnixEncoding>::new("foo.txt");
You can create Utf8Path
s from String
s, or even other Utf8Path
s:
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let string = String::from("foo.txt");
let from_string = Utf8Path::<Utf8UnixEncoding>::new(&string);
let from_path = Utf8Path::new(&from_string);
assert_eq!(from_string, from_path);
There are also handy aliases to the Utf8Path
with Utf8Encoding
:
use typed_path::Utf8UnixPath;
let string = String::from("foo.txt");
let from_string = Utf8UnixPath::new(&string);
let from_path = Utf8UnixPath::new(&from_string);
assert_eq!(from_string, from_path);
Examples found in repository?
More examples
sourcepub fn to_path_buf(&self) -> Utf8PathBuf<T>
pub fn to_path_buf(&self) -> Utf8PathBuf<T>
Converts a Utf8Path
to an owned Utf8PathBuf
.
Examples
use typed_path::{Utf8Path, Utf8PathBuf, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let path_buf = Utf8Path::<Utf8UnixEncoding>::new("foo.txt").to_path_buf();
assert_eq!(path_buf, Utf8PathBuf::from("foo.txt"));
sourcepub fn is_absolute(&self) -> bool
pub fn is_absolute(&self) -> bool
Returns true
if the Utf8Path
is absolute, i.e., if it is independent of
the current directory.
-
On Unix (
Utf8UnixPath
]), a path is absolute if it starts with the root, sois_absolute
andhas_root
are equivalent. -
On Windows (
Utf8WindowsPath
), a path is absolute if it has a prefix and starts with the root:c:\windows
is absolute, whilec:temp
and\temp
are not.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
assert!(!Utf8Path::<Utf8UnixEncoding>::new("foo.txt").is_absolute());
sourcepub fn is_relative(&self) -> bool
pub fn is_relative(&self) -> bool
Returns true
if the Utf8Path
is relative, i.e., not absolute.
See is_absolute
’s documentation for more details.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
assert!(Utf8Path::<Utf8UnixEncoding>::new("foo.txt").is_relative());
sourcepub fn has_root(&self) -> bool
pub fn has_root(&self) -> bool
Returns true
if the Utf8Path
has a root.
-
On Unix (
Utf8UnixPath
), a path has a root if it begins with/
. -
On Windows (
Utf8WindowsPath
), a path has a root if it:- has no prefix and begins with a separator, e.g.,
\windows
- has a prefix followed by a separator, e.g.,
c:\windows
but notc:windows
- has any non-disk prefix, e.g.,
\\server\share
- has no prefix and begins with a separator, e.g.,
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
assert!(Utf8Path::<Utf8UnixEncoding>::new("/etc/passwd").has_root());
sourcepub fn parent(&self) -> Option<&Self>
pub fn parent(&self) -> Option<&Self>
Returns the Utf8Path
without its final component, if there is one.
Returns None
if the path terminates in a root or prefix.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let path = Utf8Path::<Utf8UnixEncoding>::new("/foo/bar");
let parent = path.parent().unwrap();
assert_eq!(parent, Utf8Path::new("/foo"));
let grand_parent = parent.parent().unwrap();
assert_eq!(grand_parent, Utf8Path::new("/"));
assert_eq!(grand_parent.parent(), None);
sourcepub fn ancestors(&self) -> Utf8Ancestors<'_, T> ⓘ
pub fn ancestors(&self) -> Utf8Ancestors<'_, T> ⓘ
Produces an iterator over Utf8Path
and its ancestors.
The iterator will yield the Utf8Path
that is returned if the parent
method is used zero
or more times. That means, the iterator will yield &self
, &self.parent().unwrap()
,
&self.parent().unwrap().parent().unwrap()
and so on. If the parent
method returns
None
, the iterator will do likewise. The iterator will always yield at least one value,
namely &self
.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let mut ancestors = Utf8Path::<Utf8UnixEncoding>::new("/foo/bar").ancestors();
assert_eq!(ancestors.next(), Some(Utf8Path::new("/foo/bar")));
assert_eq!(ancestors.next(), Some(Utf8Path::new("/foo")));
assert_eq!(ancestors.next(), Some(Utf8Path::new("/")));
assert_eq!(ancestors.next(), None);
// NOTE: A path cannot be created on its own without a defined encoding
let mut ancestors = Utf8Path::<Utf8UnixEncoding>::new("../foo/bar").ancestors();
assert_eq!(ancestors.next(), Some(Utf8Path::new("../foo/bar")));
assert_eq!(ancestors.next(), Some(Utf8Path::new("../foo")));
assert_eq!(ancestors.next(), Some(Utf8Path::new("..")));
assert_eq!(ancestors.next(), Some(Utf8Path::new("")));
assert_eq!(ancestors.next(), None);
sourcepub fn file_name(&self) -> Option<&str>
pub fn file_name(&self) -> Option<&str>
Returns the final component of the Utf8Path
, if there is one.
If the path is a normal file, this is the file name. If it’s the path of a directory, this is the directory name.
Returns None
if the path terminates in ..
.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
assert_eq!(Some("bin"), Utf8Path::<Utf8UnixEncoding>::new("/usr/bin/").file_name());
assert_eq!(Some("foo.txt"), Utf8Path::<Utf8UnixEncoding>::new("tmp/foo.txt").file_name());
assert_eq!(Some("foo.txt"), Utf8Path::<Utf8UnixEncoding>::new("foo.txt/.").file_name());
assert_eq!(Some("foo.txt"), Utf8Path::<Utf8UnixEncoding>::new("foo.txt/.//").file_name());
assert_eq!(None, Utf8Path::<Utf8UnixEncoding>::new("foo.txt/..").file_name());
assert_eq!(None, Utf8Path::<Utf8UnixEncoding>::new("/").file_name());
sourcepub fn strip_prefix<P>(&self, base: P) -> Result<&Utf8Path<T>, StripPrefixError>where
P: AsRef<Utf8Path<T>>,
pub fn strip_prefix<P>(&self, base: P) -> Result<&Utf8Path<T>, StripPrefixError>where P: AsRef<Utf8Path<T>>,
Returns a path that, when joined onto base
, yields self
.
Errors
If base
is not a prefix of self
(i.e., starts_with
returns false
), returns Err
.
Examples
use typed_path::{Utf8Path, Utf8PathBuf, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let path = Utf8Path::<Utf8UnixEncoding>::new("/test/haha/foo.txt");
assert_eq!(path.strip_prefix("/"), Ok(Utf8Path::new("test/haha/foo.txt")));
assert_eq!(path.strip_prefix("/test"), Ok(Utf8Path::new("haha/foo.txt")));
assert_eq!(path.strip_prefix("/test/"), Ok(Utf8Path::new("haha/foo.txt")));
assert_eq!(path.strip_prefix("/test/haha/foo.txt"), Ok(Utf8Path::new("")));
assert_eq!(path.strip_prefix("/test/haha/foo.txt/"), Ok(Utf8Path::new("")));
assert!(path.strip_prefix("test").is_err());
assert!(path.strip_prefix("/haha").is_err());
let prefix = Utf8PathBuf::<Utf8UnixEncoding>::from("/test/");
assert_eq!(path.strip_prefix(prefix), Ok(Utf8Path::new("haha/foo.txt")));
sourcepub fn starts_with<P>(&self, base: P) -> boolwhere
P: AsRef<Utf8Path<T>>,
pub fn starts_with<P>(&self, base: P) -> boolwhere P: AsRef<Utf8Path<T>>,
Determines whether base
is a prefix of self
.
Only considers whole path components to match.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let path = Utf8Path::<Utf8UnixEncoding>::new("/etc/passwd");
assert!(path.starts_with("/etc"));
assert!(path.starts_with("/etc/"));
assert!(path.starts_with("/etc/passwd"));
assert!(path.starts_with("/etc/passwd/")); // extra slash is okay
assert!(path.starts_with("/etc/passwd///")); // multiple extra slashes are okay
assert!(!path.starts_with("/e"));
assert!(!path.starts_with("/etc/passwd.txt"));
assert!(!Utf8Path::<Utf8UnixEncoding>::new("/etc/foo.rs").starts_with("/etc/foo"));
sourcepub fn ends_with<P>(&self, child: P) -> boolwhere
P: AsRef<Utf8Path<T>>,
pub fn ends_with<P>(&self, child: P) -> boolwhere P: AsRef<Utf8Path<T>>,
Determines whether child
is a suffix of self
.
Only considers whole path components to match.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let path = Utf8Path::<Utf8UnixEncoding>::new("/etc/resolv.conf");
assert!(path.ends_with("resolv.conf"));
assert!(path.ends_with("etc/resolv.conf"));
assert!(path.ends_with("/etc/resolv.conf"));
assert!(!path.ends_with("/resolv.conf"));
assert!(!path.ends_with("conf")); // use .extension() instead
sourcepub fn file_stem(&self) -> Option<&str>
pub fn file_stem(&self) -> Option<&str>
Extracts the stem (non-extension) portion of self.file_name
.
The stem is:
None
, if there is no file name;- The entire file name if there is no embedded
.
; - The entire file name if the file name begins with
.
and has no other.
s within; - Otherwise, the portion of the file name before the final
.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
assert_eq!("foo", Utf8Path::<Utf8UnixEncoding>::new("foo.rs").file_stem().unwrap());
assert_eq!("foo.tar", Utf8Path::<Utf8UnixEncoding>::new("foo.tar.gz").file_stem().unwrap());
sourcepub fn extension(&self) -> Option<&str>
pub fn extension(&self) -> Option<&str>
Extracts the extension of self.file_name
, if possible.
The extension is:
None
, if there is no file name;None
, if there is no embedded.
;None
, if the file name begins with.
and has no other.
s within;- Otherwise, the portion of the file name after the final
.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
assert_eq!("rs", Utf8Path::<Utf8UnixEncoding>::new("foo.rs").extension().unwrap());
assert_eq!("gz", Utf8Path::<Utf8UnixEncoding>::new("foo.tar.gz").extension().unwrap());
sourcepub fn join<P: AsRef<Utf8Path<T>>>(&self, path: P) -> Utf8PathBuf<T>
pub fn join<P: AsRef<Utf8Path<T>>>(&self, path: P) -> Utf8PathBuf<T>
Creates an owned Utf8PathBuf
with path
adjoined to self
.
See Utf8PathBuf::push
for more details on what it means to adjoin a path.
Examples
use typed_path::{Utf8Path, Utf8PathBuf, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
assert_eq!(
Utf8Path::<Utf8UnixEncoding>::new("/etc").join("passwd"),
Utf8PathBuf::from("/etc/passwd"),
);
sourcepub fn with_file_name<S: AsRef<str>>(&self, file_name: S) -> Utf8PathBuf<T>
pub fn with_file_name<S: AsRef<str>>(&self, file_name: S) -> Utf8PathBuf<T>
Creates an owned Utf8PathBuf
like self
but with the given file name.
See Utf8PathBuf::set_file_name
for more details.
Examples
use typed_path::{Utf8Path, Utf8PathBuf, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let path = Utf8Path::<Utf8UnixEncoding>::new("/tmp/foo.txt");
assert_eq!(path.with_file_name("bar.txt"), Utf8PathBuf::from("/tmp/bar.txt"));
// NOTE: A path cannot be created on its own without a defined encoding
let path = Utf8Path::<Utf8UnixEncoding>::new("/tmp");
assert_eq!(path.with_file_name("var"), Utf8PathBuf::from("/var"));
sourcepub fn with_extension<S: AsRef<str>>(&self, extension: S) -> Utf8PathBuf<T>
pub fn with_extension<S: AsRef<str>>(&self, extension: S) -> Utf8PathBuf<T>
Creates an owned Utf8PathBuf
like self
but with the given extension.
See Utf8PathBuf::set_extension
for more details.
Examples
use typed_path::{Utf8Path, Utf8PathBuf, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let path = Utf8Path::<Utf8UnixEncoding>::new("foo.rs");
assert_eq!(path.with_extension("txt"), Utf8PathBuf::from("foo.txt"));
// NOTE: A path cannot be created on its own without a defined encoding
let path = Utf8Path::<Utf8UnixEncoding>::new("foo.tar.gz");
assert_eq!(path.with_extension(""), Utf8PathBuf::from("foo.tar"));
assert_eq!(path.with_extension("xz"), Utf8PathBuf::from("foo.tar.xz"));
assert_eq!(path.with_extension("").with_extension("txt"), Utf8PathBuf::from("foo.txt"));
sourcepub fn components(&self) -> <T as Utf8Encoding<'_>>::Components
pub fn components(&self) -> <T as Utf8Encoding<'_>>::Components
Produces an iterator over the Utf8Component
s of the path.
When parsing the path, there is a small amount of normalization:
-
Repeated separators are ignored, so
a/b
anda//b
both havea
andb
as components. -
Occurrences of
.
are normalized away, except if they are at the beginning of the path. For example,a/./b
,a/b/
,a/b/.
anda/b
all havea
andb
as components, but./a/b
starts with an additionalCurDir
component. -
A trailing slash is normalized away,
/a/b
and/a/b/
are equivalent.
Note that no other normalization takes place; in particular, a/c
and a/b/../c
are distinct, to account for the possibility that b
is a symbolic link (so its parent isn’t a
).
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding, unix::Utf8UnixComponent};
// NOTE: A path cannot be created on its own without a defined encoding
let mut components = Utf8Path::<Utf8UnixEncoding>::new("/tmp/foo.txt").components();
assert_eq!(components.next(), Some(Utf8UnixComponent::RootDir));
assert_eq!(components.next(), Some(Utf8UnixComponent::Normal("tmp")));
assert_eq!(components.next(), Some(Utf8UnixComponent::Normal("foo.txt")));
assert_eq!(components.next(), None)
Examples found in repository?
More examples
sourcepub fn iter(&self) -> Utf8Iter<'_, T> ⓘ
pub fn iter(&self) -> Utf8Iter<'_, T> ⓘ
Produces an iterator over the path’s components viewed as str
slices.
For more information about the particulars of how the path is separated
into components, see components
.
Examples
use typed_path::{Utf8Path, Utf8UnixEncoding};
// NOTE: A path cannot be created on its own without a defined encoding
let mut it = Utf8Path::<Utf8UnixEncoding>::new("/tmp/foo.txt").iter();
assert_eq!(it.next(), Some(typed_path::unix::SEPARATOR_STR));
assert_eq!(it.next(), Some("tmp"));
assert_eq!(it.next(), Some("foo.txt"));
assert_eq!(it.next(), None)
sourcepub fn into_path_buf(self: Box<Utf8Path<T>>) -> Utf8PathBuf<T>
pub fn into_path_buf(self: Box<Utf8Path<T>>) -> Utf8PathBuf<T>
Converts a Box<Utf8Path>
into a
Utf8PathBuf
without copying or allocating.
sourcepub fn from_bytes_path<U>(path: &Path<U>) -> Result<&Self, Utf8Error>where
U: for<'enc> Encoding<'enc>,
pub fn from_bytes_path<U>(path: &Path<U>) -> Result<&Self, Utf8Error>where U: for<'enc> Encoding<'enc>,
Converts a non-UTF-8 Path
to a UTF-8 Utf8PathBuf
by checking that the path contains
valid UTF-8.
Errors
Returns Err
if the path is not UTF-8 with a description as to why the
provided component is not UTF-8.
Examples
use typed_path::{Path, Utf8Path, UnixEncoding, Utf8UnixEncoding};
let path = Path::<UnixEncoding>::new(&[0xf0, 0x9f, 0x92, 0x96]);
let utf8_path = Utf8Path::<Utf8UnixEncoding>::from_bytes_path(&path).unwrap();
assert_eq!(utf8_path.as_str(), "💖");
sourcepub unsafe fn from_bytes_path_unchecked<U>(path: &Path<U>) -> &Selfwhere
U: for<'enc> Encoding<'enc>,
pub unsafe fn from_bytes_path_unchecked<U>(path: &Path<U>) -> &Selfwhere U: for<'enc> Encoding<'enc>,
Converts a non-UTF-8 Path
to a UTF-8 Utf8Path
without checking that the path
contains valid UTF-8.
See the safe version, from_bytes_path
, for more information.
Safety
The path passed in must be valid UTF-8.
Examples
use typed_path::{Path, Utf8Path, UnixEncoding, Utf8UnixEncoding};
let path = Path::<UnixEncoding>::new(&[0xf0, 0x9f, 0x92, 0x96]);
let utf8_path = unsafe {
Utf8Path::<Utf8UnixEncoding>::from_bytes_path_unchecked(&path)
};
assert_eq!(utf8_path.as_str(), "💖");
sourcepub fn as_bytes_path<U>(&self) -> &Path<U>where
U: for<'enc> Encoding<'enc>,
pub fn as_bytes_path<U>(&self) -> &Path<U>where U: for<'enc> Encoding<'enc>,
Trait Implementations§
source§impl<'a, T> AsRef<Utf8Path<T>> for Utf8Iter<'a, T>where
T: for<'enc> Utf8Encoding<'enc> + 'a,
impl<'a, T> AsRef<Utf8Path<T>> for Utf8Iter<'a, T>where T: for<'enc> Utf8Encoding<'enc> + 'a,
source§impl<T> AsRef<Utf8Path<T>> for Utf8PathBuf<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> AsRef<Utf8Path<T>> for Utf8PathBuf<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> AsRef<Utf8Path<T>> for Utf8UnixComponent<'_>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> AsRef<Utf8Path<T>> for Utf8UnixComponent<'_>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> AsRef<Utf8Path<T>> for Utf8UnixComponents<'_>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> AsRef<Utf8Path<T>> for Utf8UnixComponents<'_>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> AsRef<Utf8Path<T>> for Utf8WindowsComponent<'_>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> AsRef<Utf8Path<T>> for Utf8WindowsComponent<'_>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> AsRef<Utf8Path<T>> for Utf8WindowsComponents<'_>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> AsRef<Utf8Path<T>> for Utf8WindowsComponents<'_>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> Borrow<Utf8Path<T>> for Utf8PathBuf<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> Borrow<Utf8Path<T>> for Utf8PathBuf<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> Debug for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> Debug for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> Display for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> Display for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> From<&'a Utf8Path<T>> for Cow<'a, Utf8Path<T>>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> From<&'a Utf8Path<T>> for Cow<'a, Utf8Path<T>>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> From<Cow<'_, Utf8Path<T>>> for Box<Utf8Path<T>>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> From<Cow<'_, Utf8Path<T>>> for Box<Utf8Path<T>>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> From<Utf8PathBuf<T>> for Box<Utf8Path<T>>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> From<Utf8PathBuf<T>> for Box<Utf8Path<T>>where T: for<'enc> Utf8Encoding<'enc>,
source§fn from(p: Utf8PathBuf<T>) -> Box<Utf8Path<T>>
fn from(p: Utf8PathBuf<T>) -> Box<Utf8Path<T>>
Converts a Utf8PathBuf
into a Box<Utf8Path>
.
This conversion currently should not allocate memory, but this behavior is not guaranteed on all platforms or in all future versions.
source§impl<T> Hash for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> Hash for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> IntoIterator for &'a Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> IntoIterator for &'a Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> Ord for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> Ord for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, 'b, T> PartialEq<&'a Utf8Path<T>> for Cow<'b, str>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, 'b, T> PartialEq<&'a Utf8Path<T>> for Cow<'b, str>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<&'a Utf8Path<T>> for Stringwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<&'a Utf8Path<T>> for Stringwhere T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<&'a Utf8Path<T>> for Utf8PathBuf<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<&'a Utf8Path<T>> for Utf8PathBuf<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<&'a Utf8Path<T>> for strwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<&'a Utf8Path<T>> for strwhere T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<&'a str> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<&'a str> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, 'b, T> PartialEq<&'b Utf8Path<T>> for Cow<'a, Utf8Path<T>>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, 'b, T> PartialEq<&'b Utf8Path<T>> for Cow<'a, Utf8Path<T>>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, 'b, T> PartialEq<Cow<'a, Utf8Path<T>>> for &'b Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, 'b, T> PartialEq<Cow<'a, Utf8Path<T>>> for &'b Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<Cow<'a, Utf8Path<T>>> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<Cow<'a, Utf8Path<T>>> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<Cow<'a, str>> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<Cow<'a, str>> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, 'b, T> PartialEq<Cow<'b, str>> for &'a Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, 'b, T> PartialEq<Cow<'b, str>> for &'a Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<String> for &'a Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<String> for &'a Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> PartialEq<String> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialEq<String> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<Utf8Path<T>> for &'a strwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<Utf8Path<T>> for &'a strwhere T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<Utf8Path<T>> for Cow<'a, Utf8Path<T>>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<Utf8Path<T>> for Cow<'a, Utf8Path<T>>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<Utf8Path<T>> for Cow<'a, str>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<Utf8Path<T>> for Cow<'a, str>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> PartialEq<Utf8Path<T>> for Stringwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialEq<Utf8Path<T>> for Stringwhere T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> PartialEq<Utf8Path<T>> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialEq<Utf8Path<T>> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> PartialEq<Utf8Path<T>> for Utf8PathBuf<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialEq<Utf8Path<T>> for Utf8PathBuf<T>where T: for<'enc> Utf8Encoding<'enc>,
source§impl<T> PartialEq<Utf8Path<T>> for strwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialEq<Utf8Path<T>> for strwhere T: for<'enc> Utf8Encoding<'enc>,
source§impl<'a, T> PartialEq<Utf8PathBuf<T>> for &'a Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialEq<Utf8PathBuf<T>> for &'a Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§fn eq(&self, other: &Utf8PathBuf<T>) -> bool
fn eq(&self, other: &Utf8PathBuf<T>) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl<T> PartialEq<Utf8PathBuf<T>> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialEq<Utf8PathBuf<T>> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§fn eq(&self, other: &Utf8PathBuf<T>) -> bool
fn eq(&self, other: &Utf8PathBuf<T>) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl<'a, 'b, T> PartialOrd<&'a Utf8Path<T>> for Cow<'b, str>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, 'b, T> PartialOrd<&'a Utf8Path<T>> for Cow<'b, str>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<&'a Utf8Path<T>> for Stringwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<&'a Utf8Path<T>> for Stringwhere T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<&'a Utf8Path<T>> for Utf8PathBuf<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<&'a Utf8Path<T>> for Utf8PathBuf<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<&'a Utf8Path<T>> for strwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<&'a Utf8Path<T>> for strwhere T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<&'a str> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<&'a str> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, 'b, T> PartialOrd<&'b Utf8Path<T>> for Cow<'a, Utf8Path<T>>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, 'b, T> PartialOrd<&'b Utf8Path<T>> for Cow<'a, Utf8Path<T>>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, 'b, T> PartialOrd<Cow<'a, Utf8Path<T>>> for &'b Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, 'b, T> PartialOrd<Cow<'a, Utf8Path<T>>> for &'b Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<Cow<'a, Utf8Path<T>>> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<Cow<'a, Utf8Path<T>>> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<Cow<'a, str>> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<Cow<'a, str>> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, 'b, T> PartialOrd<Cow<'b, str>> for &'a Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, 'b, T> PartialOrd<Cow<'b, str>> for &'a Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<String> for &'a Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<String> for &'a Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<T> PartialOrd<String> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialOrd<String> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<Utf8Path<T>> for &'a strwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<Utf8Path<T>> for &'a strwhere T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<Utf8Path<T>> for Cow<'a, Utf8Path<T>>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<Utf8Path<T>> for Cow<'a, Utf8Path<T>>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<Utf8Path<T>> for Cow<'a, str>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<Utf8Path<T>> for Cow<'a, str>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<T> PartialOrd<Utf8Path<T>> for Stringwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialOrd<Utf8Path<T>> for Stringwhere T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<T> PartialOrd<Utf8Path<T>> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialOrd<Utf8Path<T>> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<T> PartialOrd<Utf8Path<T>> for Utf8PathBuf<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialOrd<Utf8Path<T>> for Utf8PathBuf<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<T> PartialOrd<Utf8Path<T>> for strwhere
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialOrd<Utf8Path<T>> for strwhere T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<Utf8PathBuf<T>> for &'a Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<Utf8PathBuf<T>> for &'a Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§fn partial_cmp(&self, other: &Utf8PathBuf<T>) -> Option<Ordering>
fn partial_cmp(&self, other: &Utf8PathBuf<T>) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<T> PartialOrd<Utf8PathBuf<T>> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialOrd<Utf8PathBuf<T>> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
source§fn partial_cmp(&self, other: &Utf8PathBuf<T>) -> Option<Ordering>
fn partial_cmp(&self, other: &Utf8PathBuf<T>) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a, T> PartialOrd<str> for &'a Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<'a, T> PartialOrd<str> for &'a Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<T> PartialOrd<str> for Utf8Path<T>where
T: for<'enc> Utf8Encoding<'enc>,
impl<T> PartialOrd<str> for Utf8Path<T>where T: for<'enc> Utf8Encoding<'enc>,
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read more