Trait typed_path::Utf8Component

source · 
pub trait Utf8Component<'a>: AsRef<str> + Clone + Debug + PartialEq + Eq + PartialOrd + Ord + Sealed {
    // Required methods
    fn as_str(&self) -> &'a str;
    fn is_root(&self) -> bool;
    fn is_normal(&self) -> bool;
    fn is_parent(&self) -> bool;
    fn is_current(&self) -> bool;
    fn len(&self) -> usize;
    fn root() -> Self;
    fn parent() -> Self;
    fn current() -> Self;

    // Provided method
    fn is_empty(&self) -> bool { ... }
}
Expand description

Interface representing a component in a Utf8Path

Required Methods§

source

fn as_str(&self) -> &'a str

Extracts the underlying str slice

source

fn is_root(&self) -> bool

Returns true if this component is the root component, meaning there are no more components before this one

Use cases are for the root dir separator on Windows and Unix as well as Windows std::path::PrefixComponent

Examples

/my/../path/./here.txt has the components on Unix of

  • UnixComponent::RootDir - is_root() == true
  • UnixComponent::ParentDir - is_root() == false
  • UnixComponent::CurDir - is_root() == false
  • UnixComponent::Normal("here.txt") - is_root() == false
source

fn is_normal(&self) -> bool

Returns true if this component represents a normal part of the path

Examples

/my/../path/./here.txt has the components on Unix of

  • UnixComponent::RootDir - is_normal() == false
  • UnixComponent::ParentDir - is_normal() == false
  • UnixComponent::CurDir - is_normal() == false
  • UnixComponent::Normal("here.txt") - is_normal() == true
source

fn is_parent(&self) -> bool

Returns true if this component represents a relative representation of a parent directory

Examples

/my/../path/./here.txt has the components on Unix of

  • UnixComponent::RootDir - is_parent() == false
  • UnixComponent::ParentDir - is_parent() == true
  • UnixComponent::CurDir - is_parent() == false
  • UnixComponent::Normal("here.txt") - is_parent() == false
source

fn is_current(&self) -> bool

Returns true if this component represents a relative representation of the current directory

Examples

/my/../path/./here.txt has the components on Unix of

  • UnixComponent::RootDir - is_current() == false
  • UnixComponent::ParentDir - is_current() == false
  • UnixComponent::CurDir - is_current() == true
  • UnixComponent::Normal("here.txt") - is_current() == false
source

fn len(&self) -> usize

Returns size of component in bytes

source

fn root() -> Self

Returns a root Utf8Component.

source

fn parent() -> Self

Returns a parent directory Utf8Component.

source

fn current() -> Self

Returns a current directory Utf8Component.

Provided Methods§

source

fn is_empty(&self) -> bool

Returns true if component represents an empty str

Object Safety§

This trait is not object safe.

Implementors§