Struct OwnedFields 

pub struct OwnedFields { /* private fields */ }

A remainder that owns its fields, for keeping the fields a section does not take beyond the lifetime of the input, in order.

Use a Vec<FieldRef> instead to borrow them without copying. A section interprets owned fields by reference, keeping their original positions:

use base_message::{FieldSection, FieldType, FieldValueError, OwnedFields, ascii_text, combination::Singleton};

struct Text(String);

impl FieldType<'_> for Text {
    type Combination = Singleton;
    fn parse(value: &[u8]) -> Result<Self, FieldValueError> {
        Ok(Self(ascii_text(value)?.to_owned()))
    }
}

#[derive(FieldSection)]
struct Transport {
    #[field("host")]
    host: Text,
}

#[derive(FieldSection)]
struct Application {
    #[field("x-request-id")]
    request_id: Option<Text>,
}

let (_, rest): (Transport, OwnedFields) = Transport::partition([("Host", "example.com"), ("X-Request-Id", "abc")])?;
let application = Application::interpret(&rest)?;
assert_eq!(application.request_id.map(|id| id.0).as_deref(), Some("abc"));

Implementations

impl OwnedFields

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

The fields, in order.

pub fn as_slice(&self) -> &[OwnedField]

The fields, in order, as a slice.

pub fn len(&self) -> usize

The number of fields.

pub fn is_empty(&self) -> bool

Whether there are no fields.

pub fn values<'a>( &'a self, name: &'a str, ) -> impl Iterator<Item = &'a [u8]> + 'a

The values of every field named name, compared case-insensitively, in order.

Trait Implementations

impl Clone for OwnedFields

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OwnedFields

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

Formats the value using the given formatter.

impl Default for OwnedFields

fn default() -> Self

Returns the “default value” for a type.

impl Eq for OwnedFields

impl<'a> Extend<FieldRef<'a>> for OwnedFields

fn extend<I: IntoIterator<Item = FieldRef<'a>>>(&mut self, fields: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: T)

🔬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<'a> FromIterator<FieldRef<'a>> for OwnedFields

fn from_iter<I: IntoIterator<Item = FieldRef<'a>>>(fields: I) -> Self

Creates a value from an iterator.

impl Hash for OwnedFields

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 OwnedFields

type Item = &'a OwnedField

The type of the elements being iterated over.

type IntoIter = Iter<'a, OwnedField>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for OwnedFields

type Item = OwnedField

The type of the elements being iterated over.

type IntoIter = IntoIter<OwnedField>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for OwnedFields

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OwnedFields