Struct log::RecordBuilder

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

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();

Implementations

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 module_path_static( &mut self, path: Option<&'static str>, ) -> &mut RecordBuilder<'a>

Set module_path to a 'static string

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

Set file

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

Set file to a 'static string.

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

Set line

pub fn key_values(&mut self, kvs: &'a dyn Source) -> &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.

impl<'a> Default for RecordBuilder<'a>

fn default() -> Self

Returns the “default value” for a type.