🛈 Note: This is pre-release documentation for the upcoming tracing 0.2.0 ecosystem.

For the release documentation, please see docs.rs, instead.

pub struct FieldSet { /* private fields */ }
Expand description

Describes the fields present on a span.

§Equality

In well-behaved applications, two FieldSets initialized with equal callsite identifiers will have identical fields. Consequently, in release builds, FieldSet::eq only checks that its arguments have equal callsites. However, the equality of field names is checked in debug builds.

Implementations§

source§

impl FieldSet

source

pub const fn new(names: &'static [&'static str], callsite: Identifier) -> Self

Constructs a new FieldSet with the given array of field names and callsite.

source

pub fn field<Q>(&self, name: &Q) -> Option<Field>
where Q: Borrow<str> + ?Sized,

Returns the Field named name, or None if no such field exists.

source

pub fn contains(&self, field: &Field) -> bool

Returns true if self contains the given field.

Note: If field shares a name with a field
in this FieldSet, but was created by a FieldSet
with a different callsite, this FieldSet does not
contain it. This is so that if two separate span callsites define a field
named "foo", the Field corresponding to "foo" for each
of those callsites are not equivalent.
source

pub fn iter(&self) -> Iter

Returns an iterator over the Fields in this FieldSet.

source

pub fn len(&self) -> usize

Returns the number of fields in this FieldSet.

source

pub fn is_empty(&self) -> bool

Returns whether or not this FieldSet has fields.

Trait Implementations§

source§

impl Debug for FieldSet

source§

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

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

impl Display for FieldSet

source§

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

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

impl<'a> IntoIterator for &'a FieldSet

§

type IntoIter = Iter

Which kind of iterator are we turning this into?
§

type Item = Field

The type of the elements being iterated over.
source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
source§

impl PartialEq for FieldSet

source§

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Eq for FieldSet

Auto Trait Implementations§

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.