Struct RequestId 

pub struct RequestId { /* private fields */ }

128-bit request identifier rendered as RFC 4122 UUIDv4.

Implementations

impl RequestId

pub fn new() -> Self

Construct a fresh RequestId from the global generator.

pub fn from_pair(high: u64, low: u64) -> Self

Construct a RequestId from raw 64-bit halves, applying the UUIDv4 version (0x4) and variant (0b10) bits.

pub fn as_hex(&self) -> String

32-character lowercase hex (no dashes).

pub fn as_uuid(&self) -> String

36-character UUID format with dashes (8-4-4-4-12).

pub fn high(&self) -> u64

High 64 bits.

pub fn low(&self) -> u64

Low 64 bits.

pub fn from_hex(s: &str) -> Option<Self>

Parse a 32-char hex string (no dashes) back into a RequestId.

Returns None if the input is malformed.

pub fn from_uuid(s: &str) -> Option<Self>

Parse a UUID-formatted string (with dashes) back into a RequestId.

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

Return the raw 16 bytes of this request id in big-endian order (high half first).

Equivalent to [high.to_be_bytes(), low.to_be_bytes()].concat(), without an allocation. Useful for binary protocols that store request ids alongside other binary payloads.

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

Reconstruct a RequestId from its 16-byte big-endian representation.

Note: this preserves the bytes as-is (UUIDv4 version + variant nibbles are NOT re-imposed), so round-tripping through as_bytes -> from_bytes yields the same id. To enforce the v4 layout from arbitrary bytes, pipe through RequestId::from_pair explicitly.

Trait Implementations

impl Clone for RequestId

fn clone(&self) -> RequestId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestId

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

Formats the value using the given formatter.

impl Default for RequestId

fn default() -> Self

Returns the “default value” for a type.

impl Display for RequestId

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

Formats the value using the given formatter.

impl Hash for RequestId

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 RequestId

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

impl Eq for RequestId

impl StructuralPartialEq for RequestId