Struct DomainBuilder 

pub struct DomainBuilder { /* private fields */ }

Available on crate feature net only.

Builder for a Domain.

Labels are pushed in DNS-natural order: leftmost (most specific) first, rightmost (TLD) last. The builder maintains the Domain invariant after every successful push.

Backed by SmolStrBuilder, so domains up to the inline cap stay on the stack — no heap allocation in the common case.

Example

use rama_net::address::domain::DomainBuilder;

let mut b = DomainBuilder::new();
b.push_label("www").unwrap();
b.push_label("example").unwrap();
b.push_label("com").unwrap();
let d = b.finish().unwrap();
assert_eq!(d.as_str(), "www.example.com");

Implementations

impl DomainBuilder

pub fn new() -> DomainBuilder

Creates an empty builder.

pub fn label_count(&self) -> usize

Returns the number of labels currently in the builder.

pub fn is_empty(&self) -> bool

Returns true if no labels have been pushed yet.

pub fn len(&self) -> usize

Returns the current length in bytes (including separating dots).

pub fn push_label( &mut self, label: &str, ) -> Result<&mut DomainBuilder, PushError>

Push a single label.

label must satisfy Label’s invariants. The total name length after the push (including the joining dot) must not exceed Domain::MAX_NAME_LEN (253).

Errors

Returns PushError if the label or resulting name length is invalid.

pub fn push(&mut self, label: &Label) -> Result<&mut DomainBuilder, PushError>

Push an already-validated Label reference.

Still enforces the total name length cap.

Errors

Returns a too-long PushError if the resulting name length would exceed Domain::MAX_NAME_LEN.

pub fn push_labels<'a, I>( &mut self, it: I, ) -> Result<&mut DomainBuilder, PushError>

where I: IntoIterator<Item = &'a Label>,

Push every label from it in iteration order.

Errors

Returns the first PushError encountered. On error, the builder retains the labels that pushed successfully — the caller may still inspect or discard it.

pub fn append<D>(&mut self, other: &D) -> Result<&mut DomainBuilder, PushError>

where D: DomainLabels + ?Sized,

Append every label from another label-aware value (e.g. a Domain or Host).

Errors

Returns the first PushError encountered.

pub fn push_label_segments( &mut self, dotted: &str, ) -> Result<&mut DomainBuilder, PushError>

Parse dotted as a sequence of labels separated by ., ignoring empty segments (i.e. leading and trailing FQDN dots are accepted).

Errors

Returns PushError on the first invalid label or length overflow.

pub fn finish(self) -> Result<Domain, PushError>

Consume the builder and produce a Domain.

Errors

Returns a PushError if the builder is empty, or if the only pushed label is the bare wildcard "*" (which is never a valid standalone domain).

Trait Implementations

impl Debug for DomainBuilder

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

Formats the value using the given formatter.

impl Default for DomainBuilder

fn default() -> DomainBuilder

Returns the “default value” for a type.