Struct TraceId

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

Available on crate feature trace only.

A 16-byte value which identifies a given trace.

The id is valid if it contains at least one non-zero byte.

Implementations

impl TraceId

Helper to create trace ids for testing

pub fn from_u128(num: u128) -> Self

Available on crate feature testing only.

impl TraceId

pub const INVALID: TraceId = _

Invalid trace id

pub const fn from_bytes(bytes: [u8; 16]) -> Self

Create a trace id from its representation as a byte array.

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

Return the representation of this trace id as a byte array.

pub fn from_hex(hex: &str) -> Result<Self, ParseIntError>

Converts a string in base 16 to a trace id.

Examples

use opentelemetry::trace::TraceId;

assert!(TraceId::from_hex("42").is_ok());
assert!(TraceId::from_hex("58406520a006649127e371903a2de979").is_ok());

assert!(TraceId::from_hex("not_hex").is_err());

Trait Implementations

impl Clone for TraceId

fn clone(&self) -> TraceId

Returns a copy 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 From<u128> for TraceId

fn from(value: u128) -> Self

Converts to this type from the input type.

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 LowerHex for TraceId

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

Formats the value using the given formatter.

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 Copy for TraceId

impl Eq for TraceId

impl StructuralPartialEq for TraceId