Struct UUID

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

A Universally Unique Identifier (UUID).

UUIDs are 128-bit (16-byte) identifiers that are designed to be unique across space and time. This implementation creates type 4 (random) UUIDs, following the UUID specification:

• Version field (bits 48-51) is set to 4, indicating a random UUID
• Variant field (bits 64-65) is set to 2, indicating RFC 4122/DCE 1.1 UUID variant

Unlike ARIDs, UUIDs:

• Are shorter (128 bits vs 256 bits)
• Contain version and variant metadata within the identifier
• Have a canonical string representation with 5 groups separated by hyphens

The canonical textual representation of a UUID takes the form: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx where each x is a hexadecimal digit.

Implementations

impl UUID

pub const UUID_SIZE: usize = 16usize

pub fn new() -> Self

Creates a new type 4 (random) UUID.

pub fn from_data(data: [u8; 16]) -> Self

Restores a UUID from data.

pub fn from_data_ref(data: impl AsRef<[u8]>) -> Option<Self>

Restores a UUID from data.

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

Returns the data of the UUID.

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

Get the data of the UUID as a byte slice.

Trait Implementations

impl AsRef<[u8]> for UUID

Implements AsRef<u8> to allow UUID to be treated as a byte slice.

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl CBORTagged for UUID

Implements CBORTagged trait to provide CBOR tag information.

fn cbor_tags() -> Vec<Tag>

Returns the CBOR tags associated with this type.

impl CBORTaggedDecodable for UUID

Implements CBORTaggedDecodable to provide CBOR decoding functionality.

fn from_untagged_cbor(cbor: CBOR) -> Result<Self>

Creates an instance of this type by decoding it from untagged CBOR.

fn from_tagged_cbor(cbor: CBOR) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from tagged CBOR.

fn from_tagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded tagged CBOR.

fn from_untagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded untagged CBOR.

impl CBORTaggedEncodable for UUID

Implements CBORTaggedEncodable to provide CBOR encoding functionality.

fn untagged_cbor(&self) -> CBOR

Returns the untagged CBOR encoding of this instance.

fn tagged_cbor(&self) -> CBOR

Returns the tagged CBOR encoding of this instance.

fn tagged_cbor_data(&self) -> Vec<u8>

Returns the tagged value in CBOR binary representation.

impl Clone for UUID

fn clone(&self) -> UUID

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UUID

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

Formats the value using the given formatter.

impl Default for UUID

Implements Default for UUID to create a new random UUID.

fn default() -> Self

Returns the “default value” for a type.

impl Display for UUID

Implements Display for UUID to format it in the standard UUID string format.

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

Formats the value using the given formatter.

impl<'a> From<&'a UUID> for &'a [u8; 16]

Implements conversion from a UUID reference to a byte array reference.

fn from(value: &'a UUID) -> Self

Converts to this type from the input type.

impl From<&UUID> for String

Implements conversion from UUID reference to String.

fn from(uuid: &UUID) -> Self

Converts to this type from the input type.

impl From<UUID> for CBOR

Implements conversion from UUID to CBOR for serialization.

fn from(value: UUID) -> Self

Converts to this type from the input type.

impl From<UUID> for String

Implements conversion from UUID to String in the standard format with dashes.

fn from(uuid: UUID) -> Self

Converts to this type from the input type.

impl FromStr for UUID

Implements string parsing to create a UUID.

type Err = Error

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 PartialEq for UUID

fn eq(&self, other: &UUID) -> 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 TryFrom<CBOR> for UUID

Implements TryFrom<CBOR> for UUID to support conversion from CBOR data.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(cbor: CBOR) -> Result<Self>

Performs the conversion.

impl Copy for UUID

impl Eq for UUID

impl StructuralPartialEq for UUID