Struct simplelog::CombinedLogger

pub struct CombinedLogger { /* fields omitted */ }

The CombinedLogger struct. Provides a Logger implementation that proxies multiple Loggers as one.

The purpose is to allow multiple Loggers to be set globally

Methods

impl CombinedLogger

pub fn init(logger: Vec<Box<SharedLogger>>) -> Result<(), SetLoggerError>

init function. Globally initializes the CombinedLogger as the one and only used log facility.

Takes all used Loggers as a Vector argument. None of those Loggers should already be set globally.

All loggers need to implement log::Log and logger::SharedLogger and need to provide a way to be initialized without calling set_logger. All loggers of this library provide a `new(..)`` method for that purpose. Fails if another logger is already set globally.

Examples

let _ = CombinedLogger::init(
            vec![
                TermLogger::new(LevelFilter::Info, Config::default()).unwrap(),
                WriteLogger::new(LevelFilter::Info, Config::default(), File::create("my_rust_bin.log").unwrap())
            ]
        );

Important traits for Box<R>

impl<R> Read for Box<R> where
    R: Read + ?Sized, impl<W> Write for Box<W> where
    W: Write + ?Sized, impl<I> Iterator for Box<I> where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn new(logger: Vec<Box<SharedLogger>>) -> Box<CombinedLogger>

allows to create a new logger, that can be independently used, no matter whats globally set.

no macros are provided for this case and you probably dont want to use this function, but init(), if you dont want to build a CombinedLogger.

Takes all used loggers as a Vector argument. The log level is automatically determined by the lowest log level used by the given loggers.

All loggers need to implement log::Log.

Examples

let combined_logger = CombinedLogger::new(
            vec![
                TermLogger::new(LevelFilter::Debug, Config::default()).unwrap(),
                WriteLogger::new(LevelFilter::Info, Config::default(), File::create("my_rust_bin.log").unwrap())
            ]
        );

Trait Implementations

impl Log for CombinedLogger

fn enabled(&self, metadata: &Metadata) -> bool

Determines if a log message with the specified metadata would be logged.

fn log(&self, record: &Record)

Logs the Record.

fn flush(&self)

Flushes any buffered records.

impl SharedLogger for CombinedLogger

fn level(&self) -> LevelFilter

Returns the set Level for this Logger

fn config(&self) -> Option<&Config>

Inspect the config of a running Logger

Important traits for Box<R>

impl<R> Read for Box<R> where
    R: Read + ?Sized, impl<W> Write for Box<W> where
    W: Write + ?Sized, impl<I> Iterator for Box<I> where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

fn as_log(self: Box<Self>) -> Box<Log>

Returns the logger as a Log trait object