Struct silent::Configs

pub struct Configs { /* private fields */ }

A type map of protocol extensions.

Configs can be used by Request and Response to store extra data derived from the underlying protocol.

Implementations

impl Configs

pub fn new() -> Configs

Create an empty Configs.

pub fn insert<T: Send + Sync + Clone + 'static>(&mut self, val: T) -> Option<T>

Insert a type into this Configs.

If a extension of this type already existed, it will be returned.

Example

let mut cfg = Configs::new();
assert!(cfg.insert(5i32).is_none());
assert!(cfg.insert(4u8).is_none());
assert_eq!(cfg.insert(9i32), Some(5i32));

pub fn get<T: Send + Sync + 'static>(&self) -> Option<&T>

Get a reference to a type previously inserted on this Configs.

Example

let mut cfg = Configs::new();
assert!(cfg.get::<i32>().is_none());
cfg.insert(5i32);

assert_eq!(cfg.get::<i32>(), Some(&5i32));

pub fn remove<T: Send + Sync + Clone + 'static>(&mut self) -> Option<T>

Remove a type from this Configs.

If a extension of this type existed, it will be returned.

Example

let mut cfg = Configs::new();
cfg.insert(5i32);
assert_eq!(cfg.remove::<i32>(), Some(5i32));
assert!(cfg.get::<i32>().is_none());

pub fn clear(&mut self)

Clear the Configs of all inserted extensions.

Example

let mut cfg = Configs::new();
cfg.insert(5i32);
cfg.clear();

assert!(cfg.get::<i32>().is_none());

pub fn is_empty(&self) -> bool

Check whether the extension set is empty or not.

Example

let mut cfg = Configs::new();
assert!(cfg.is_empty());
cfg.insert(5i32);
assert!(!cfg.is_empty());

pub fn len(&self) -> usize

Get the numer of extensions available.

Example

let mut cfg = Configs::new();
assert_eq!(cfg.len(), 0);
cfg.insert(5i32);
assert_eq!(cfg.len(), 1);

Trait Implementations

impl Clone for Configs

fn clone(&self) -> Configs

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Configs

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

Formats the value using the given formatter.

impl Default for Configs

fn default() -> Configs

Returns the “default value” for a type.