Cross-platform path manipulation.
This module provides two types,
Path (akin to
str), for working with paths abstractly. These types are thin wrappers around
OsStr respectively, meaning that they work directly on strings according to the local platform's path syntax.
Paths can be parsed into
Components by iterating over the structure returned by the
components method on
Components roughly correspond to the substrings between path separators (
/ or ). You can reconstruct an equivalent path from components with the
push method on
PathBuf; note that the paths may differ syntactically by the normalization described in the documentation for the
Path manipulation includes both parsing components from slices and building new owned paths.
use std::path::Path; use std::ffi::OsStr; let path = Path::new("/tmp/foo/bar.txt"); let parent = path.parent(); assert_eq!(parent, Some(Path::new("/tmp/foo"))); let file_stem = path.file_stem(); assert_eq!(file_stem, Some(OsStr::new("bar"))); let extension = path.extension(); assert_eq!(extension, Some(OsStr::new("txt")));
To build or modify paths, use
use std::path::PathBuf; // This way works... let mut path = PathBuf::from("c:\\"); path.push("windows"); path.push("system32"); path.set_extension("dll"); // ... but push is best used if you don't know everything up // front. If you do, this way is better: let path: PathBuf = ["c:\\", "windows", "system32.dll"].iter().collect();
An iterator over
Helper struct for safely printing paths with
A slice of a path (akin to
An owned, mutable path (akin to
A structure wrapping a Windows path prefix as well as its unparsed string representation.
An error returned from
A single component of a path.
Windows path prefixes, e.g.,
The primary separator of path components for the current platform.
Determines whether the character is one of the permitted path separators for the current platform.
© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.