Struct Record 

pub struct Record<'a> {
    pub metadata: Metadata<'a>,
    pub message: &'a str,
    pub fields: &'a [Field<'a>],
    pub context: &'a [Field<'a>],
}

A complete, immutable log record.

Records borrow their data; the lifetime parameter is the shortest of the borrows. A crate::Sink receives a &Record and must not outlive it.

Fields

metadata: Metadata<'a>

Static origin and severity information.

message: &'a str

Free-form message.

fields: &'a [Field<'a>]

Borrowed structured fields. May be empty.

context: &'a [Field<'a>]

Borrowed context fields. May be empty. Distinct from fields so formatters can label them (for example, prefixing context keys in human format) and filters can skip them.

Implementations

impl<'a> Record<'a>

pub const fn new( metadata: Metadata<'a>, message: &'a str, fields: &'a [Field<'a>], ) -> Self

Build a record with no context fields.

pub const fn with_context( metadata: Metadata<'a>, message: &'a str, fields: &'a [Field<'a>], context: &'a [Field<'a>], ) -> Self

Build a record with explicit context fields.

pub fn all_fields(&self) -> impl Iterator<Item = &Field<'a>>

Iterate over context fields followed by structured fields.

Most formatters render them in this order so context appears before the per-call data.

Trait Implementations

impl<'a> Clone for Record<'a>

fn clone(&self) -> Record<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Record<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for Record<'a>