Struct quil::Context

pub struct Context(_);

A logging context.

Contexts contain meta data for the association with logged messages.

Methods

impl Context

fn new() -> Self

Creates a new context for use with a logger.

fn set<S>(&mut self, key: S, value: S) where
    S: Into<String>, 

Sets a value within the context by a given key.

Arguments

• key - A key for the value.
• value - The value to add to the context.

Examples

Setting a value:

ctx.set("key", "value");

Clearing a value:

ctx.set("key", "");

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

Gets a value by key.

If the key does not exist then None will be returned.

Arguments

• key - A key for the value.

Examples

ctx.set("key", "value");
assert_eq!(ctx.get("key").unwrap(), "value");

fn merge(&self, context: Self) -> Self

Create a new merged context from the context merge is called upon and a given context. The given context's values take precedence.

Arguments

• context - A context that will be merged.

Examples

let context_a = context!{ a: "1", b: "2" };
let context_b = context!{ b: "3", c: "4" };

let merged_context = context_a.merge(context_b);

assert_eq!(merged_context.get("a").unwrap(), "1");
assert_eq!(merged_context.get("b").unwrap(), "3");
assert_eq!(merged_context.get("c").unwrap(), "4");

fn iter(&self) -> Iter<String, String>

Returns an iterator to iterate through the data contained within the context.

fn into_iter(self) -> IntoIter<String, String>

Consumes the context returning an iterator to iterate through the data once contained within the context.

Trait Implementations

impl Debug for Context

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Clone for Context

fn clone(&self) -> Context

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Display for Context

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

Formats the value using the given formatter.