Skip to main content

StringRepr

Enum StringRepr 

Source
#[non_exhaustive]
pub enum StringRepr { String, SmolStr, EcoString, CompactString, }
Expand description

The Rust type a proto string field maps to in generated owned structs.

The default is String. The other variants are small-string-optimized types that avoid String’s growable buffer for read-mostly schemas; each is gated behind the matching buffa Cargo feature (smol_str, ecow, compact_str), and the downstream crate must enable that feature so the re-exported type path (::buffa::smol_str::SmolStr, etc.) resolves.

Select a representation through buffa_build’s string_type / string_type_in builder methods. The wire format is identical regardless of representation — only the in-memory owned type changes; view types keep borrowing &str, and map<_, string> / map<string, _> keys and values always stay String.

Sizes below are for 64-bit targets. See the buffa README for a fuller comparison of the small-string crates.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

String

::buffa::alloc::string::String — 24-byte struct, growable and mutable (the default).

§

SmolStr

smol_str::SmolStr — 24-byte struct, inlines up to 23 bytes, O(1) clone of long strings via Arc<str>. Immutable (assign a new value to mutate). Requires the buffa/smol_str feature.

§

EcoString

ecow::EcoString — 16-byte struct, inlines up to 15 bytes, clone-on-write with O(1) clone. Immutable (assign a new value to mutate). Requires the buffa/ecow feature.

§

CompactString

compact_str::CompactString — 24-byte struct, inlines up to 24 bytes, mutable (a drop-in String replacement). Requires the buffa/compact_str feature.

Trait Implementations§

Source§

impl Clone for StringRepr

Source§

fn clone(&self) -> StringRepr

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for StringRepr

Source§

impl Debug for StringRepr

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for StringRepr

Source§

fn default() -> StringRepr

Returns the “default value” for a type. Read more
Source§

impl Eq for StringRepr

Source§

impl PartialEq for StringRepr

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

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

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

impl StructuralPartialEq for StringRepr

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.