Path::dirname

pub fn dirname() -> Result<Path, IoError>

use path::{Path};

Returns the path without its last component.

Trailing separators are ignored. A path with no separator gives .; a path directly under the root gives /.

Called on a Path value as value.dirname(…).

Returns#

Result<Path, IoError>

Examples#

use path::{Path};
use tests::assert;
assert!((Path::from("a/b/c.txt").dirname() ?? Path::from("")).as_str() == "a/b");
assert!((Path::from("/top").dirname() ?? Path::from("")).as_str() == "/");
assert!((Path::from("file").dirname() ?? Path::from("")).as_str() == ".");

See also#

• Path: A file-system path, with helpers to take it apart and to use it.
• Path::from: Creates a path from s as written.
• Path::as_str: Returns the path as a string.
• Path::join: Returns this path followed by other, with exactly one separator between them.
• Path::basename: Returns the last component, ignoring trailing separators ("" for an empty path or /).
• Path::extension: Returns the text after the last . of the last component, or "" when there is none.
• Path::is_absolute: Returns true when the path starts with a separator or a Windows drive letter (C:).
• Path::normalize: Removes . components, resolves .. against the component before it, and collapses repeated separators.