Struct log::kv::Value

source ·
pub struct Value<'v> { /* private fields */ }
Expand description

A value in a structured key-value pair.

Capturing values

There are a few ways to capture a value:

  • Using the Value::capture_* methods.
  • Using the Value::from_* methods.
  • Using the ToValue trait.
  • Using the standard From trait.

Using the Value::capture_* methods

Value offers a few constructor methods that capture values of different kinds. These methods require a T: 'static to support downcasting.

use log::kv::Value;

let value = Value::capture_debug(&42i32);

assert_eq!(Some(42), value.to_i64());

Using the Value::from_* methods

Value offers a few constructor methods that capture values of different kinds. These methods don’t require T: 'static, but can’t support downcasting.

use log::kv::Value;

let value = Value::from_debug(&42i32);

assert_eq!(None, value.to_i64());

Using the ToValue trait

The ToValue trait can be used to capture values generically. It’s the bound used by Source.

let value = 42i32.to_value();

assert_eq!(Some(42), value.to_i64());
use log::kv::ToValue;

let value = (&42i32 as &dyn Debug).to_value();

assert_eq!(None, value.to_i64());

Using the standard From trait

Standard types that implement ToValue also implement From.

use log::kv::Value;

let value = Value::from(42i32);

assert_eq!(Some(42), value.to_i64());

Implementations§

source§

impl<'v> Value<'v>

source

pub fn from_any<T>(value: &'v T) -> Self
where T: ToValue,

Get a value from a type implementing ToValue.

source

pub fn capture_debug<T>(value: &'v T) -> Self
where T: Debug + 'static,

Get a value from a type implementing std::fmt::Debug.

source

pub fn capture_display<T>(value: &'v T) -> Self
where T: Display + 'static,

Get a value from a type implementing std::fmt::Display.

source

pub fn from_debug<T>(value: &'v T) -> Self
where T: Debug,

Get a value from a type implementing std::fmt::Debug.

source

pub fn from_display<T>(value: &'v T) -> Self
where T: Display,

Get a value from a type implementing std::fmt::Display.

source

pub fn from_dyn_debug(value: &'v dyn Debug) -> Self

Get a value from a dynamic std::fmt::Debug.

source

pub fn from_dyn_display(value: &'v dyn Display) -> Self

Get a value from a dynamic std::fmt::Display.

source

pub fn is<T: 'static>(&self) -> bool

Check whether this value can be downcast to T.

source

pub fn downcast_ref<T: 'static>(&self) -> Option<&T>

Try downcast this value to T.

source

pub fn visit(&self, visitor: impl Visit<'v>) -> Result<(), Error>

Inspect this value using a simple visitor.

source§

impl<'v> Value<'v>

source

pub fn to_u64(&self) -> Option<u64>

Try convert this value into a u64.

source

pub fn to_i64(&self) -> Option<i64>

Try convert this value into a i64.

source

pub fn to_u128(&self) -> Option<u128>

Try convert this value into a u128.

source

pub fn to_i128(&self) -> Option<i128>

Try convert this value into a i128.

source

pub fn to_f64(&self) -> Option<f64>

Try convert this value into a f64.

source

pub fn to_char(&self) -> Option<char>

Try convert this value into a char.

source

pub fn to_bool(&self) -> Option<bool>

Try convert this value into a bool.

source§

impl<'v> Value<'v>

source

pub fn to_borrowed_str(&self) -> Option<&str>

Try convert this value into a borrowed string.

Trait Implementations§

source§

impl<'v> Debug for Value<'v>

source§

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

Formats the value using the given formatter. Read more
source§

impl<'v> Display for Value<'v>

source§

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

Formats the value using the given formatter. Read more
source§

impl<'v> From<&'v NonZeroI128> for Value<'v>

source§

fn from(v: &'v NonZeroI128) -> Value<'v>

Converts to this type from the input type.
source§

impl<'v> From<&'v NonZeroU128> for Value<'v>

source§

fn from(v: &'v NonZeroU128) -> Value<'v>

Converts to this type from the input type.
source§

impl<'v> From<&'v i128> for Value<'v>

source§

fn from(value: &'v i128) -> Self

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

impl<'v> From<&'v u128> for Value<'v>

source§

fn from(value: &'v u128) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroI16> for Value<'v>

source§

fn from(value: NonZeroI16) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroI32> for Value<'v>

source§

fn from(value: NonZeroI32) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroI64> for Value<'v>

source§

fn from(value: NonZeroI64) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroI8> for Value<'v>

source§

fn from(value: NonZeroI8) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroIsize> for Value<'v>

source§

fn from(value: NonZeroIsize) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroU16> for Value<'v>

source§

fn from(value: NonZeroU16) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroU32> for Value<'v>

source§

fn from(value: NonZeroU32) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroU64> for Value<'v>

source§

fn from(value: NonZeroU64) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroU8> for Value<'v>

source§

fn from(value: NonZeroU8) -> Self

Converts to this type from the input type.
source§

impl<'v> From<NonZeroUsize> for Value<'v>

source§

fn from(value: NonZeroUsize) -> Self

Converts to this type from the input type.
source§

impl<'v> From<bool> for Value<'v>

source§

fn from(value: bool) -> Self

Converts to this type from the input type.
source§

impl<'v> From<char> for Value<'v>

source§

fn from(value: char) -> Self

Converts to this type from the input type.
source§

impl<'v> From<f32> for Value<'v>

source§

fn from(value: f32) -> Self

Converts to this type from the input type.
source§

impl<'v> From<f64> for Value<'v>

source§

fn from(value: f64) -> Self

Converts to this type from the input type.
source§

impl<'v> From<i16> for Value<'v>

source§

fn from(value: i16) -> Self

Converts to this type from the input type.
source§

impl<'v> From<i32> for Value<'v>

source§

fn from(value: i32) -> Self

Converts to this type from the input type.
source§

impl<'v> From<i64> for Value<'v>

source§

fn from(value: i64) -> Self

Converts to this type from the input type.
source§

impl<'v> From<i8> for Value<'v>

source§

fn from(value: i8) -> Self

Converts to this type from the input type.
source§

impl<'v> From<isize> for Value<'v>

source§

fn from(value: isize) -> Self

Converts to this type from the input type.
source§

impl<'v> From<u16> for Value<'v>

source§

fn from(value: u16) -> Self

Converts to this type from the input type.
source§

impl<'v> From<u32> for Value<'v>

source§

fn from(value: u32) -> Self

Converts to this type from the input type.
source§

impl<'v> From<u64> for Value<'v>

source§

fn from(value: u64) -> Self

Converts to this type from the input type.
source§

impl<'v> From<u8> for Value<'v>

source§

fn from(value: u8) -> Self

Converts to this type from the input type.
source§

impl<'v> From<usize> for Value<'v>

source§

fn from(value: usize) -> Self

Converts to this type from the input type.
source§

impl<'v> ToValue for Value<'v>

source§

fn to_value(&self) -> Value<'_>

Perform the conversion.

Auto Trait Implementations§

§

impl<'v> !RefUnwindSafe for Value<'v>

§

impl<'v> !Send for Value<'v>

§

impl<'v> !Sync for Value<'v>

§

impl<'v> Unpin for Value<'v>

§

impl<'v> !UnwindSafe for Value<'v>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

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

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.