Skip to main content

RepeatedRepr

Enum RepeatedRepr 

Source
#[non_exhaustive]
pub enum RepeatedRepr { Vec, Custom(String), }
Expand description

The owned Rust collection a proto repeated field maps to in generated owned structs.

The default is Vec (Vec<T>). Custom substitutes any collection that satisfies the buffa::ProtoList<T> bound — for example a crate-local newtype wrapping a SmallVec-backed inline collection. Unlike the scalar string/bytes knobs the custom collection wraps the element type, so its path is a template containing a * placeholder where the element type is substituted (e.g. "::my_crate::SmallList<*>").

Because buffa::ProtoList is buffa-owned, a foreign collection cannot implement it directly (orphan rule) — the template must always name a crate-local newtype, mirroring the ProtoString newtype expectation.

Select a representation through buffa_build’s repeated_type_custom builder method. The wire format is identical regardless of the collection; view types keep borrowing &[T].

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.
§

Vec

::buffa::alloc::vec::Vec<T> — the default. Keeps the Vec-specialized fast paths (in-place push/reserve/clear, native Arbitrary) instead of the generic ProtoList ones, so generated output for the default is byte-identical to a build without the knob.

§

Custom(String)

A custom collection named by a Rust type-path template with a * placeholder for the element type (e.g. "::my_crate::SmallList<*>"). The named type must satisfy buffa::ProtoList<T> and be a crate-local newtype (a foreign collection cannot implement the buffa-owned ProtoList).

§Limitations

  • The template must contain at least one *; the element type is substituted for every * before the result is parsed as a Rust type. A template that omits * surfaces as CodeGenError::MissingListPlaceholder, and one whose substitution does not parse as CodeGenError::InvalidTypePath, at generation (.compile()) time.
  • A custom collection always needs a crate-local newtype — this is not limited to the reflection path. The generated decode and clear code require Field: ProtoList, so even a binary-only build cannot use a foreign collection directly.
  • Under reflection / vtable the newtype must implement buffa_descriptor’s ReflectList (a Vec-backed newtype can delegate to the inner Vec<T>: ReflectList). Under JSON it must implement serde::Serialize / Deserialize; under the arbitrary feature, arbitrary::Arbitrary (derivable on a newtype).
  • A repeated <self-type> field becomes Collection<Self>, so the collection must be heap-backed; an inline collection (SmallVec<[Self; N]>) would be infinitely sized and fail to compile.

Trait Implementations§

Source§

impl Clone for RepeatedRepr

Source§

fn clone(&self) -> RepeatedRepr

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 Debug for RepeatedRepr

Source§

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

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

impl Default for RepeatedRepr

Source§

fn default() -> RepeatedRepr

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

impl Eq for RepeatedRepr

Source§

impl PartialEq for RepeatedRepr

Source§

fn eq(&self, other: &RepeatedRepr) -> 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 RepeatedRepr

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.