# [−] [src] Struct log::Record

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

The "payload" of a log message.

# Use

`Record` structures are passed as parameters to the `log` method of the `Log` trait. Logger implementors manipulate these structures in order to display log messages. `Record`s are automatically created by the `log!` macro and so are not seen by log users.

Note that the `level()` and `target()` accessors are equivalent to `self.metadata().level()` and `self.metadata().target()` respectively. These methods are provided as a convenience for users of this structure.

# Example

The following example shows a simple logger that displays the level, module path, and message of any `Record` that is passed to it.

ⓘThis code runs with edition 2018

    struct SimpleLogger;

    impl log::Log for SimpleLogger {
       fn enabled(&self, metadata: &log::Metadata) -> bool {
           true
       }

       fn log(&self, record: &log::Record) {
           if !self.enabled(record.metadata()) {
               return;
           }

           println!("{}:{} -- {}",
                    record.level(),
                    record.target(),
                    record.args());
       }
       fn flush(&self) {}
    }

## Implementations

### `impl<'a> Record<'a>` [src]

#### `pub fn builder() -> RecordBuilder<'a>` [src]

Returns a new builder.

#### `pub fn args(&self) -> &Arguments<'a>` [src]

The message body.

#### `pub fn metadata(&self) -> &Metadata<'a>` [src]

Metadata about the log directive.

#### `pub fn level(&self) -> Level` [src]

The verbosity level of the message.

#### `pub fn target(&self) -> &'a str` [src]

The name of the target of the directive.

#### `pub fn module_path(&self) -> Option<&'a str>` [src]

The module path of the message.

#### `pub fn module_path_static(&self) -> Option<&'static str>` [src]

The module path of the message, if it is a `'static` string.

#### `pub fn file(&self) -> Option<&'a str>` [src]

The source file containing the message.

#### `pub fn file_static(&self) -> Option<&'static str>` [src]

The module path of the message, if it is a `'static` string.

#### `pub fn line(&self) -> Option<u32>` [src]

The line containing the message.

## Trait Implementations

### `impl<'a> Clone for Record<'a>` [src]

#### `fn clone(&self) -> Record<'a>` [src]

Returns a copy of the value. Read more

#### `fn clone_from(&mut self, source: &Self)`1.0.0 [src]

Performs copy-assignment from `source`. Read more

### `impl<'a> Debug for Record<'a>` [src]

#### `fn fmt(&self, f: &mut Formatter<'_>) -> Result` [src]

Formats the value using the given formatter. Read more

## Auto Trait Implementations

### `impl<'a> !Send for Record<'a>`

### `impl<'a> !Sync for Record<'a>`

### `impl<'a> Unpin for Record<'a>`

## Blanket Implementations

### `impl<T> Any for T where
T: 'static + ?Sized,` [src]

#### `pub fn type_id(&self) -> TypeId` [src]

Gets the `TypeId` of `self`. Read more

### `impl<T> Borrow<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow(&self) -> &T` [src]

Immutably borrows from an owned value. Read more

### `impl<T> BorrowMut<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow_mut(&mut self) -> &mut T` [src]

Mutably borrows from an owned value. Read more

### `impl<T> From<T> for T` [src]

#### `pub fn from(t: T) -> T` [src]

Performs the conversion.

### `impl<T, U> Into<U> for T where
U: From<T>,` [src]

#### `pub fn into(self) -> U` [src]

Performs the conversion.

### `impl<T, U> TryFrom<U> for T where
U: Into<T>,` [src]

#### `type Error = Infallible`

The type returned in the event of a conversion error.

#### `pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>` [src]

Performs the conversion.

### `impl<T, U> TryInto<U> for T where
U: TryFrom<T>,` [src]

#### `type Error = <U as TryFrom<T>>::Error`

The type returned in the event of a conversion error.

#### `pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>` [src]

Performs the conversion.