Enum Value 

pub enum Value<'a> {
    Null,
    Bool(bool),
    I64(i64),
    U64(u64),
    F64(f64),
    Str(&'a str),
    Char(char),
}

A field value attached to a log record.

All variants borrow their data. Construct a Value at the call site from a borrowed source so the record carries no heap allocation.

Variants

Null

Absence of a value. Serializes as null in JSON, the empty string in logfmt, and <null> in the human-readable format.

Bool(bool)

A boolean.

I64(i64)

A signed 64-bit integer.

U64(u64)

An unsigned 64-bit integer.

F64(f64)

A 64-bit float. NaN and inf are serialized as JSON null per RFC 8259 since they have no JSON representation; logfmt and the human format emit the lowercase debug representation.

Str(&'a str)

A borrowed string slice.

Char(char)

A borrowed character. Serialized as a one-character string.

Implementations

impl<'a> Value<'a>

pub const fn is_null(&self) -> bool

Returns true if this value is Self::Null.

pub const fn variant_name(&self) -> &'static str

Returns the static name of the variant. Useful in diagnostics.

Trait Implementations

impl<'a> Clone for Value<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Value<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Value<'a>

fn default() -> Value<'a>

Returns the “default value” for a type.

impl<'a> Display for Value<'a>

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

Formats the value using the given formatter.

impl<'a> From<&'a str> for Value<'a>

fn from(value: &'a str) -> Self

Converts to this type from the input type.

impl<'a, T> From<Option<T>> for Value<'a>

where T: Into<Value<'a>>,

fn from(value: Option<T>) -> Self

Converts to this type from the input type.

impl From<bool> for Value<'_>

fn from(value: bool) -> Self

Converts to this type from the input type.

impl From<char> for Value<'_>

fn from(value: char) -> Self

Converts to this type from the input type.

impl From<f32> for Value<'_>

fn from(value: f32) -> Self

Converts to this type from the input type.

impl From<f64> for Value<'_>

fn from(value: f64) -> Self

Converts to this type from the input type.

impl From<i16> for Value<'_>

fn from(value: i16) -> Self

Converts to this type from the input type.

impl From<i32> for Value<'_>

fn from(value: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Value<'_>

fn from(value: i64) -> Self

Converts to this type from the input type.

impl From<i8> for Value<'_>

fn from(value: i8) -> Self

Converts to this type from the input type.

impl From<isize> for Value<'_>

fn from(value: isize) -> Self

Converts to this type from the input type.

impl From<u16> for Value<'_>

fn from(value: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Value<'_>

fn from(value: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Value<'_>

fn from(value: u64) -> Self

Converts to this type from the input type.

impl From<u8> for Value<'_>

fn from(value: u8) -> Self

Converts to this type from the input type.

impl From<usize> for Value<'_>

fn from(value: usize) -> Self

Converts to this type from the input type.

impl<'a> PartialEq for Value<'a>

fn eq(&self, other: &Value<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Copy for Value<'a>

impl<'a> StructuralPartialEq for Value<'a>