W3cubDocs

/Rust

Function std::fs::canonicalize

pub fn canonicalize<P: AsRef<Path>>(path: P) -> Result<PathBuf>

Returns the canonical form of a path with all intermediate components normalized and symbolic links resolved.

Platform-specific behavior

This function currently corresponds to the realpath function on Unix and the CreateFile and GetFinalPathNameByHandle functions on Windows. Note that, this may change in the future.

Errors

This function will return an error in the following situations, but is not limited to just these cases:

  • path does not exist.
  • A component in path is not a directory.

Examples

use std::fs;

let path = fs::canonicalize("../a/../foo.txt")?;

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/fs/fn.canonicalize.html