Struct SmolStrBuilder 

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

A builder that can be used to efficiently build a SmolStr.

This won’t allocate if the final string fits into the inline buffer.

Implementations

impl SmolStrBuilder

pub const fn new() -> Self

Creates a new empty SmolStrBuilder.

pub fn with_capacity(capacity: usize) -> Self

Creates a new empty SmolStrBuilder with at least the specified capacity.

If capacity is less than or equal to SmolStr::INLINE_CAP, the builder will use inline storage and not allocate. Otherwise, it will pre-allocate a heap buffer of the requested capacity.

pub fn len(&self) -> usize

Returns the number of bytes accumulated in the builder so far.

pub fn is_empty(&self) -> bool

Returns true if the builder has a length of zero bytes.

pub fn as_str(&self) -> &str

Returns a &str slice of the builder’s current contents.

pub fn finish(self) -> SmolStr

Builds a SmolStr from self.

pub fn push(&mut self, c: char)

Appends the given char to the end of self’s buffer.

pub fn push_str(&mut self, s: &str)

Appends a given string slice onto the end of self’s buffer.

Trait Implementations

impl Clone for SmolStrBuilder

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 SmolStrBuilder

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

Formats the value using the given formatter.

impl Default for SmolStrBuilder

fn default() -> Self

Returns the “default value” for a type.

impl Eq for SmolStrBuilder

impl<'a> Extend<&'a String> for SmolStrBuilder

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

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: T)

🔬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> Extend<&'a str> for SmolStrBuilder

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

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: T)

🔬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<char> for SmolStrBuilder

fn extend<I: IntoIterator<Item = char>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: T)

🔬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 From<SmolStrBuilder> for SmolStr

fn from(value: SmolStrBuilder) -> Self

Converts to this type from the input type.

impl PartialEq for SmolStrBuilder

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

Equality operator ==.

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

Inequality operator !=.

impl Write for SmolStrBuilder

fn write_str(&mut self, s: &str) -> Result

Writes a string slice into this writer, returning whether the write succeeded.

fn write_char(&mut self, c: char) -> Result<(), Error>

Writes a char into this writer, returning whether the write succeeded.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Glue for usage of the write! macro with implementors of this trait.