Struct TraceId 

pub struct TraceId(/* private fields */);

A W3C Trace Id.

Implementations

impl TraceId

pub fn random<R: Rng>(rng: R) -> Option<Self>

Create a random trace id.

This method will return None if the given Rng fails to produce a random value, or if it produces the value 0.

pub const fn new(v: NonZeroU128) -> Self

Create a trace id from a non-zero integer.

pub fn from_u128(v: u128) -> Option<Self>

Try create a trace id from an integer.

This method will return None if v is 0.

pub const fn to_u128(&self) -> u128

Get the value of the trace id as an integer.

pub fn from_bytes(v: [u8; 16]) -> Option<Self>

Get a trace id from a 16 byte big-endian array.

pub fn to_bytes(&self) -> [u8; 16]

Convert the trace id into a 16 byte big-endian array.

pub fn to_hex(&self) -> [u8; 32]

Convert the trace id into a 32 byte ASCII-compatible hex string, like 4bf92f3577b34da6a3ce929d0e0e4736.

pub fn try_from_hex_slice(hex: &[u8]) -> Result<Self, ParseIdError>

Try parse a slice of ASCII hex bytes into a trace id.

If hex is not a 32 byte array of valid hex characters ([a-fA-F0-9]) then this method will fail.

pub fn try_from_hex(hex: impl Display) -> Result<Self, ParseIdError>

Try parse ASCII hex characters into a trace id.

If hex is not exactly 32 valid hex characters ([a-fA-F0-9]) then this method will fail.

Trait Implementations

impl Clone for TraceId

fn clone(&self) -> TraceId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TraceId

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

Formats the value using the given formatter.

impl Display for TraceId

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

Formats the value using the given formatter.

impl FromStr for TraceId

type Err = ParseIdError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<'v> FromValue<'v> for TraceId

fn from_value(value: Value<'v>) -> Option<Self>

Perform the conversion.

impl Hash for TraceId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TraceId

fn eq(&self, other: &TraceId) -> 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 Serialize for TraceId

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl ToValue for TraceId

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

Perform the conversion.

impl Value for TraceId

Available on crate feature sval only.

fn stream<'sval, S: Stream<'sval> + ?Sized>( &'sval self, stream: &mut S, ) -> Result

Stream this value through a Stream.

fn tag(&self) -> Option<Tag>

Get the tag of this value, if there is one.

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

Try convert this value into a boolean.

fn to_f32(&self) -> Option<f32>

Try convert this value into a 32bit binary floating point number.

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

Try convert this value into a 64bit binary floating point number.

fn to_i8(&self) -> Option<i8>

Try convert this value into a signed 8bit integer.

fn to_i16(&self) -> Option<i16>

Try convert this value into a signed 16bit integer.

fn to_i32(&self) -> Option<i32>

Try convert this value into a signed 32bit integer.

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

Try convert this value into a signed 64bit integer.

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

Try convert this value into a signed 128bit integer.

fn to_u8(&self) -> Option<u8>

Try convert this value into an unsigned 8bit integer.

fn to_u16(&self) -> Option<u16>

Try convert this value into an unsigned 16bit integer.

fn to_u32(&self) -> Option<u32>

Try convert this value into an unsigned 32bit integer.

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

Try convert this value into an unsigned 64bit integer.

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

Try convert this value into an unsigned 128bit integer.

fn to_text(&self) -> Option<&str>

Try convert this value into a text string.

fn to_binary(&self) -> Option<&[u8]>

Try convert this value into a bitstring.

impl Copy for TraceId

impl Eq for TraceId

impl StructuralPartialEq for TraceId