Path

The Path struct represents file paths in the underlying filesystem. There are
two flavors of Path: posix::Path, for UNIX-like systems, and
windows::Path, for Windows. The prelude exports the appropriate
platform-specific Path variant.

A Path can be created from an OsStr, and provides several methods to get
information from the file/directory the path points to.

Note that a Path is not internally represented as an UTF-8 string, but
instead is stored as a vector of bytes (Vec<u8>). Therefore, converting a
Path to a &str is not free and may fail (an Option is returned).

  1. use std::path::Path;
  3. fn main() {
  4.     // Create a `Path` from an `&'static str`
  5.     let path = Path::new(".");
  7.     // The `display` method returns a `Show`able structure
  8.     let _display = path.display();
  10.     // `join` merges a path with a byte container using the OS specific
  11.     // separator, and returns the new path
  12.     let new_path = path.join("a").join("b");
  14.     // Convert the path into a string slice
  15.     match new_path.to_str() {
  16.         None => panic!("new path is not a valid UTF-8 sequence"),
  17.         Some(s) => println!("new path is {}", s),
  18.     }
  19. }

Be sure to check at other Path methods (posix::Path or windows::Path) and
the Metadata struct.

See also

OsStr and Metadata.