Struct Params 

pub struct Params { /* private fields */ }

An ordered list of parameters.

Implementations

impl Params

pub fn new() -> Self

An empty list.

pub fn len(&self) -> usize

How many parameters are present, counting duplicates.

pub fn is_empty(&self) -> bool

Whether the list is empty.

pub fn push(&mut self, param: Param)

Append a parameter, keeping any existing one of the same name.

pub fn remove(&mut self, name: &str) -> bool

Remove every parameter with this name, and say whether any was there.

Every one, not the first: the list preserves duplicates because a message may contain them, and leaving a second copy behind after removing the first would be a silent change of meaning rather than a removal.

pub fn iter(&self) -> impl Iterator<Item = &Param>

Every parameter, in wire order.

pub fn get(&self, name: &str) -> Option<&Param>

The first parameter with this name, if any. Names compare case-insensitively.

pub fn value(&self, name: &str) -> Option<&[u8]>

The value of the first parameter with this name.

Returns None both when the parameter is absent and when it is present without a value; use Params::contains to tell those apart, because ;lr and no lr at all mean different things.

pub fn contains(&self, name: &str) -> bool

Whether a parameter with this name is present, with or without a value.

pub fn write_to(&self, out: &mut Vec<u8>, separator: u8)

Serialize as ;name=value pairs, in order.

Trait Implementations

impl Clone for Params

fn clone(&self) -> Params

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Params

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

Formats the value using the given formatter.

impl Default for Params

fn default() -> Params

Returns the “default value” for a type.

impl FromIterator<Param> for Params

fn from_iter<T: IntoIterator<Item = Param>>(iter: T) -> Self

Creates a value from an iterator.

impl<'a> IntoIterator for &'a Params

type Item = &'a Param

The type of the elements being iterated over.

type IntoIter = Iter<'a, Param>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.