Struct CheetahBuilder 

pub struct CheetahBuilder { /* private fields */ }

Append-heavy builder for constructing Cheetah string values.

CheetahBuilder keeps mutable construction separate from immutable, clone-cheap CheetahString values.

Implementations

impl CheetahBuilder

pub fn new() -> Self

Creates an empty builder.

pub fn with_capacity(capacity: usize) -> Self

Creates an empty builder with at least capacity bytes.

pub fn from_string(value: String) -> Self

Creates a builder from existing owned storage.

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

Appends a string slice.

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

Appends a character.

pub fn reserve(&mut self, additional: usize)

Reserves capacity for at least additional more bytes.

pub fn clear(&mut self)

Clears the current contents while preserving capacity.

pub fn as_str(&self) -> &str

Returns the current contents.

pub fn len(&self) -> usize

Returns the current length in bytes.

pub fn is_empty(&self) -> bool

Returns whether the builder is empty.

pub fn capacity(&self) -> usize

Returns the allocated capacity in bytes.

pub fn finish(self) -> CheetahString

Freezes this builder into the canonical clone-cheap string value.

Use CheetahBuilder::into_string when construction is followed by more mutation or when spare capacity must be retained.

pub fn finish_string(self) -> CheetahString

👎Deprecated since 3.0.0:

use finish()

Freezes the builder into the canonical clone-cheap string value.

This compatibility name is retained so downstream v2 consumers can adopt the immutable v3 core without a source migration.

pub fn into_string(self) -> String

Returns the owned String backing this builder.

Trait Implementations

impl Clone for CheetahBuilder

fn clone(&self) -> CheetahBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CheetahBuilder

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

Formats the value using the given formatter.

impl Default for CheetahBuilder

fn default() -> CheetahBuilder

Returns the “default value” for a type.

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

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<char> for CheetahBuilder

fn extend<T: IntoIterator<Item = char>>(&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 From<&str> for CheetahBuilder

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<String> for CheetahBuilder

fn from(value: String) -> Self

Converts to this type from the input type.