Struct TopicPath 

pub struct TopicPath {
    pub path: ArcStr,
    pub segments: Vec<Substr>,
}

A concrete MQTT topic, split into its /-delimited segments.

The original topic string and the segment slices share the same backing ArcStr allocation, so cloning and slicing are cheap.

Fields

path: ArcStr

The full topic string.

segments: Vec<Substr>

The topic split on /; each segment is a slice into path.

Implementations

impl TopicPath

pub fn new(path: impl Into<ArcStr>) -> Result<Self, TopicPathError>

Builds a TopicPath by splitting path on / into segments.

Rejects a topic that is not well-formed per MQTT §4.7.3: an empty string, or one containing the null character (U+0000). Every other UTF-8 topic — including spaces and the discouraged-but-legal U+0001..U+001F control range — is accepted. The 65535-byte length ceiling is left to the wire codec, not enforced here.

pub fn path(&self) -> ArcStr

Returns a cheap (refcounted) clone of the full topic string.

Trait Implementations

impl Clone for TopicPath

fn clone(&self) -> TopicPath

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TopicPath

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

Formats the value using the given formatter.

impl Display for TopicPath

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

Formats the value using the given formatter.