Struct rustdoc::html::url_parts_builder::UrlPartsBuilder

pub(crate) struct UrlPartsBuilder {
    buf: String,
}

A builder that allows efficiently and easily constructing the part of a URL after the domain: nightly/core/str/struct.Bytes.html.

This type is a wrapper around the final String buffer, but its API is like that of a Vec of URL components.

Fields

buf: String

Implementations

impl UrlPartsBuilder

pub(crate) fn new() -> Self

Create an empty buffer.

fn with_capacity_bytes(count: usize) -> Self

Create an empty buffer with capacity for the specified number of bytes.

pub(crate) fn singleton(part: &str) -> Self

Create a buffer with one URL component.

Examples

Basic usage:

let builder = UrlPartsBuilder::singleton("core");
assert_eq!(builder.finish(), "core");

Adding more components afterward.

let mut builder = UrlPartsBuilder::singleton("core");
builder.push("str");
builder.push_front("nightly");
assert_eq!(builder.finish(), "nightly/core/str");

pub(crate) fn push(&mut self, part: &str)

Push a component onto the buffer.

Examples

Basic usage:

let mut builder = UrlPartsBuilder::new();
builder.push("core");
builder.push("str");
builder.push("struct.Bytes.html");
assert_eq!(builder.finish(), "core/str/struct.Bytes.html");

pub(crate) fn push_fmt(&mut self, args: Arguments<'_>)

Push a component onto the buffer, using format!’s formatting syntax.

Examples

Basic usage (equivalent to the example for UrlPartsBuilder::push):

let mut builder = UrlPartsBuilder::new();
builder.push("core");
builder.push("str");
builder.push_fmt(format_args!("{}.{}.html", "struct", "Bytes"));
assert_eq!(builder.finish(), "core/str/struct.Bytes.html");

pub(crate) fn push_front(&mut self, part: &str)

Push a component onto the front of the buffer.

Examples

Basic usage:

let mut builder = UrlPartsBuilder::new();
builder.push("core");
builder.push("str");
builder.push_front("nightly");
builder.push("struct.Bytes.html");
assert_eq!(builder.finish(), "nightly/core/str/struct.Bytes.html");

pub(crate) fn finish(self) -> String

Get the final String buffer.

Trait Implementations

impl Debug for UrlPartsBuilder

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

Formats the value using the given formatter.

impl<'a> Extend<&'a str> for UrlPartsBuilder

fn extend<T: IntoIterator<Item = &'a str>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl Extend<Symbol> for UrlPartsBuilder

fn extend<T: IntoIterator<Item = Symbol>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl<'a> FromIterator<&'a str> for UrlPartsBuilder

fn from_iter<T: IntoIterator<Item = &'a str>>(iter: T) -> Self

Creates a value from an iterator.

impl FromIterator<Symbol> for UrlPartsBuilder

fn from_iter<T: IntoIterator<Item = Symbol>>(iter: T) -> Self

Creates a value from an iterator.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 24 bytes