Struct log::RecordBuilder

pub struct RecordBuilder<'a> { /* fields omitted */ }

Builder for Record.

Typically should only be used by log library creators or for testing and "shim loggers". The RecordBuilder can set the different parameters of Record object, and returns the created object when build is called.

Examples

use log::{Level, Record};

let record = Record::builder()
                .args(format_args!("Error!"))
                .level(Level::Error)
                .target("myApp")
                .file(Some("server.rs"))
                .line(Some(144))
                .module_path(Some("server"))
                .build();

Alternatively, use MetadataBuilder:

use log::{Record, Level, MetadataBuilder};

let error_metadata = MetadataBuilder::new()
                        .target("myApp")
                        .level(Level::Error)
                        .build();

let record = Record::builder()
                .metadata(error_metadata)
                .args(format_args!("Error!"))
                .line(Some(433))
                .file(Some("app.rs"))
                .module_path(Some("server"))
                .build();

Methods

impl<'a> RecordBuilder<'a>

pub fn new() -> RecordBuilder<'a>

Construct new RecordBuilder.

The default options are:

• args: format_args!("")
• metadata: Metadata::builder().build()
• module_path: None
• file: None
• line: None

pub fn args(&mut self, args: Arguments<'a>) -> &mut RecordBuilder<'a>

Set args.

pub fn metadata(&mut self, metadata: Metadata<'a>) -> &mut RecordBuilder<'a>

Set metadata. Construct a Metadata object with MetadataBuilder.

pub fn level(&mut self, level: Level) -> &mut RecordBuilder<'a>

Set Metadata::level.

pub fn target(&mut self, target: &'a str) -> &mut RecordBuilder<'a>

Set Metadata::target

pub fn module_path(&mut self, path: Option<&'a str>) -> &mut RecordBuilder<'a>

Set module_path

pub fn file(&mut self, file: Option<&'a str>) -> &mut RecordBuilder<'a>

Set file

pub fn line(&mut self, line: Option<u32>) -> &mut RecordBuilder<'a>

Set line

pub fn key_values(&mut self, kvs: ErasedSource<'a>) -> &mut RecordBuilder<'a>

Set key values

pub fn build(&self) -> Record<'a>

Invoke the builder and return a Record

Trait Implementations

impl<'a> Debug for RecordBuilder<'a>

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

Formats the value using the given formatter.