Struct FieldMap 

pub struct FieldMap { /* private fields */ }

A decoded message’s fields, in the order the draft defines them.

Ordered rather than sorted because the order is information: it is the order the fields appear on the wire, which is what makes a rendering of one message comparable to a rendering of the same message from another implementation.

Implementations

impl FieldMap

pub fn new() -> Self

An empty map.

pub fn insert(&mut self, key: String, value: FieldValue)

Set key to value, replacing any value already under that key.

Replacing rather than appending keeps a duplicate key impossible, which is what lets a reader index the map. A replaced key keeps its original position, so a later correction does not reorder the message.

The key is a String rather than an impl Into<String> because the callers write "request_id".into(), and a generic bound leaves that into with nothing to infer from.

pub fn get(&self, key: &str) -> Option<&FieldValue>

The value under key, if the message carried that field.

pub fn iter(&self) -> impl Iterator<Item = (&str, &FieldValue)>

The fields, in the order the draft defines them.

pub fn is_empty(&self) -> bool

Whether the message had no fields at all. True for the handful of messages that are nothing but their type.

pub fn len(&self) -> usize

How many fields the message carried.

Trait Implementations

impl Clone for FieldMap

fn clone(&self) -> FieldMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FieldMap

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

Formats the value using the given formatter.

impl Default for FieldMap

fn default() -> FieldMap

Returns the “default value” for a type.

impl Eq for FieldMap

impl IntoIterator for FieldMap

type Item = (String, FieldValue)

The type of the elements being iterated over.

type IntoIter = IntoIter<(String, FieldValue)>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for FieldMap

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FieldMap