Struct opentelemetry::trace::TraceId

pub struct TraceId(_);

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) -> TraceId

impl TraceId

pub const INVALID: TraceId = TraceId(0)

Invalid trace id

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

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<TraceId, ParseIntError>

Converts a string in base 16 to a trace id.

Examples

use opentelemetry_api::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<(), Error>

Formats the value using the given formatter.

impl Display for TraceId

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

Formats the value using the given formatter.

impl From<[u8; 16]> for TraceId

fn from(bytes: [u8; 16]) -> TraceId

Converts to this type from the input type.

impl Hash for TraceId

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl LowerHex for TraceId

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

Formats the value using the given formatter.

impl PartialEq<TraceId> for TraceId

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

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

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.

impl Copy for TraceId

impl Eq for TraceId

impl StructuralEq for TraceId

impl StructuralPartialEq for TraceId