Struct LogRecords 

pub struct LogRecords(/* private fields */);

A set of records that can be attached to a logging scope.

LogRecords represents a set of key-value pairs that can be added to log messages when the log context scope is active.

Ordering

The order in which records appear is not guaranteed. Do not rely on any specific ordering of keys.

Implementations

impl LogRecords

pub fn new() -> Self

pub fn field( self, key: impl Into<Cow<'static, str>>, value: impl Into<LogValue>, ) -> Self

Adds a key-value record to this collection, returning the collection for chained calls.

Examples

This method takes ownership of self, so it can be used as part of a builder-style chain:

use context_logger::LogRecords;

let records = LogRecords::new()
    .field("user_id", "user-123")
    .field("request_id", 42);

pub fn insert( &mut self, key: impl Into<Cow<'static, str>>, value: impl Into<LogValue>, )

Adds a key-value record to this collection.

pub fn extend( &mut self, other: impl IntoIterator<Item = (Cow<'static, str>, LogValue)>, )

Extends this collection with the records from another collection.

pub fn iter(&self) -> Iter<'_, Cow<'static, str>, LogValue>

Returns an iterator over the records in this collection.

pub fn is_empty(&self) -> bool

Returns true if this collection contains no records.

Trait Implementations

impl Clone for LogRecords

fn clone(&self) -> LogRecords

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogRecords

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

Formats the value using the given formatter.

impl Default for LogRecords

fn default() -> LogRecords

Returns the “default value” for a type.

impl<'a> IntoIterator for &'a LogRecords

type Item = (&'a Cow<'static, str>, &'a LogValue)

The type of the elements being iterated over.

type IntoIter = Iter<'a, Cow<'static, str>, LogValue>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for LogRecords

type Item = (Cow<'static, str>, LogValue)

The type of the elements being iterated over.

type IntoIter = IntoIter<Cow<'static, str>, LogValue>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.