Struct ValidatedTopic 

pub struct ValidatedTopic(/* private fields */);

A newtype wrapper that guarantees its inner String is a valid MQTT topic.

This type prevents the cost of repeated validation for topics that are used frequently. It can only be constructed via ValidatedTopic::new, which performs a one-time validation check.

Use this when publishing repeatedly to the same topic to avoid per-call validation overhead in publish APIs that accept PublishTopic.

Implementations

impl ValidatedTopic

pub fn new<S: Into<String>>(topic: S) -> Result<Self, InvalidTopic>

Constructs a new ValidatedTopic after validating the input string.

Errors

Returns InvalidTopic if the topic string does not conform to the MQTT specification.

Trait Implementations

impl Clone for ValidatedTopic

fn clone(&self) -> ValidatedTopic

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ValidatedTopic

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

Formats the value using the given formatter.

impl From<ValidatedTopic> for PublishTopic

fn from(topic: ValidatedTopic) -> Self

Converts to this type from the input type.

impl From<ValidatedTopic> for String

fn from(topic: ValidatedTopic) -> Self

Converts to this type from the input type.

impl PartialEq for ValidatedTopic

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ValidatedTopic

impl StructuralPartialEq for ValidatedTopic