Struct NamespacePath 

pub struct NamespacePath { /* private fields */ }

Canonical absolute path represented as exact logical-name components.

An empty component vector denotes the volume root. Unlike PortablePath, this type preserves raw POSIX bytes and Windows UTF-16LE names. A volume executor additionally checks that every component encoding is admitted by that volume’s filesystem profile.

Implementations

impl NamespacePath

pub fn new( components: Vec<LogicalName>, limits: VolumeLimits, ) -> Result<Self, NamespacePathError>

Constructs one bounded absolute namespace path.

Errors

Rejects excessive depth, component bytes, total bytes, or arithmetic overflow before the path reaches a storage backend.

pub fn from_portable( path: &PortablePath, limits: VolumeLimits, ) -> Result<Self, NamespacePathError>

Converts a strict UTF-8 portable path without losing information.

Errors

Returns the same component and total bounds as Self::new, plus a canonical-name failure if the portable input violates the name format.

pub fn from_portable_in_profile( path: &PortablePath, profile: FilesystemProfile, limits: VolumeLimits, ) -> Result<Self, NamespacePathError>

Converts a portable path to the canonical names of one volume profile.

The string API can address names representable as Unicode; native capture APIs retain raw POSIX bytes or UTF-16 units outside that subset.

Errors

Returns bounded-name or path errors when the encoded host names exceed the volume limits.

pub fn is_root(&self) -> bool

Returns whether this is the volume root.

pub fn depth(&self) -> usize

Exact logical path depth.

pub const fn encoded_bytes(&self) -> u32

Canonical encoded bytes including separators and the leading root mark.

pub fn components(&self) -> &[LogicalName]

Borrows exact logical-name components in root-to-leaf order.

pub fn split_last(&self) -> Option<(&[LogicalName], &LogicalName)>

Returns the parent path and final name, or None for root.

pub fn parent(&self) -> Option<Self>

Returns the exact parent path, or None for the namespace root.

This preserves the already-validated component representation and does not consult a filesystem or allocate beyond cloning the parent prefix.

pub fn is_within(&self, ancestor: &Self) -> bool

Returns whether this path is equal to or below ancestor.

Trait Implementations

impl Clone for NamespacePath

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NamespacePath

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

Formats the value using the given formatter.

impl Eq for NamespacePath

impl Ord for NamespacePath

fn cmp(&self, other: &Self) -> 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.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for NamespacePath

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for NamespacePath

fn partial_cmp(&self, other: &Self) -> 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 NamespacePath