Struct UnknownFields 

pub struct UnknownFields { /* private fields */ }

A collection of unknown fields encountered during decoding.

When a message is decoded with a schema that doesn’t include all fields present on the wire, the unknown fields are stored here so they can be re-encoded without data loss.

Implementations

impl UnknownFields

pub fn new() -> Self

Creates an empty set of unknown fields.

pub fn is_empty(&self) -> bool

Returns true if no unknown fields have been recorded.

pub fn len(&self) -> usize

Returns the number of unknown fields recorded.

pub fn push(&mut self, field: UnknownField)

Appends an unknown field.

pub fn iter(&self) -> Iter<'_, UnknownField>

Returns an iterator over the recorded unknown fields.

pub fn clear(&mut self)

Removes all recorded unknown fields.

pub fn retain(&mut self, f: impl FnMut(&UnknownField) -> bool)

Retain only the fields for which the predicate returns true.

Used by ExtensionSet::set_extension and clear_extension to remove prior occurrences at a given field number.

pub fn encoded_len(&self) -> usize

Compute the encoded size of all unknown fields.

pub fn write_to(&self, buf: &mut impl BufMut)

Re-encode all unknown fields to buf in their original wire format.

pub fn decode_from_slice(data: &[u8]) -> Result<Self, DecodeError>

Decode a concatenation of wire-format fields into UnknownFields.

Reads tag/data pairs until data is exhausted. Each field is decoded via decode_unknown_field with the full RECURSION_LIMIT budget.

Used by GroupCodec to turn a message’s encoded bytes back into the inner-field representation that UnknownFieldData::Group wraps.

Errors

Returns DecodeError if data contains a malformed tag, truncated field, or exceeds the recursion limit.

Trait Implementations

impl<'a> Arbitrary<'a> for UnknownFields

Available on crate feature arbitrary only.

fn arbitrary(_u: &mut Unstructured<'a>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for UnknownFields

fn clone(&self) -> UnknownFields

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnknownFields

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

Formats the value using the given formatter.

impl Default for UnknownFields

fn default() -> UnknownFields

Returns the “default value” for a type.

impl Hash for UnknownFields

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> IntoIterator for &'a UnknownFields

type Item = &'a UnknownField

The type of the elements being iterated over.

type IntoIter = Iter<'a, UnknownField>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for UnknownFields

type Item = UnknownField

The type of the elements being iterated over.

type IntoIter = IntoIter<UnknownField>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for UnknownFields

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl StructuralPartialEq for UnknownFields