Struct OwnedPath 

pub struct OwnedPath { /* private fields */ }

OwnedPath is the equivalent of PathBuf in the normal std library. It is a path whose inner representation is a String. The path can be modified by adding other paths using the OwnedPath::push method.

Implementations

impl OwnedPath

pub fn new() -> Self

Creates a new, empty owned path.

pub fn as_path(&self) -> &Path

pub fn push<P: AsRef<Path>>(&mut self, segment: P)

Appends another path to the end of this path. If the other path is absolute, but this path is not empty, then the path will be appended as a relative path.

use kstd::path::owned::OwnedPath;
let mut path = OwnedPath::from("foo");
path.push("/bar");
assert_eq!(path.to_string(), "foo/bar");

Pushing a parent directory will not remove the last component of the path:

use kstd::path::owned::OwnedPath;
let mut path = OwnedPath::from("foo/bar");
path.push("..");
assert_eq!(path.to_string(), "foo/bar/..");

Pushing a root dir is a no-op if the path is not empty, otherwise it will make this path absolute.

use kstd::path::owned::OwnedPath;
let mut path = OwnedPath::new();
path.push("/");
path.push("foo");
assert_eq!(path.to_string(), "/foo");

Pushing a current dir is always a no-op and will not modify the path in any way.

pub fn into_components(self) -> Vec<OwnedPath>

Converts the path into its components.

use kstd::path::owned::OwnedPath;
let mut my_root = OwnedPath::from("/my/path");
assert_eq!(vec![OwnedPath::from("my"), OwnedPath::from("path")], my_root.into_components());

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn components(&self) -> Components<'_>

Trait Implementations

impl Borrow<Path> for OwnedPath

fn borrow(&self) -> &Path

Immutably borrows from an owned value.

impl Clone for OwnedPath

fn clone(&self) -> OwnedPath

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OwnedPath

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OwnedPath

fn default() -> Self

Returns the “default value” for a type.

impl Display for OwnedPath

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for OwnedPath

impl<P: AsRef<Path>> From<P> for OwnedPath

fn from(v: P) -> Self

Converts to this type from the input type.

impl Ord for OwnedPath

fn cmp(&self, other: &OwnedPath) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for OwnedPath

fn eq(&self, other: &OwnedPath) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for OwnedPath

fn partial_cmp(&self, other: &OwnedPath) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for OwnedPath