Struct GUID

pub struct GUID { /* private fields */ }

A GUID backed by 16 byte array.

Implementations

impl GUID

pub const fn build_from_components( d1: u32, d2: u16, d3: u16, d4: &[u8; 8], ) -> Self

Construct a GUID from components.

let guid = guid_create::GUID::build_from_components(
    0x87935CDE,
    0x7094,
    0x4C2B,
    &[ 0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61 ]
);

assert_eq!(guid.data1(), 0x87935CDE);
assert_eq!(guid.data2(), 0x7094);
assert_eq!(guid.data3(), 0x4C2B);
assert_eq!(guid.data4(), [ 0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61 ]);
assert_eq!(guid.to_string(), "87935CDE-7094-4C2B-A0F4-DD7D512DD261");

pub const fn build_from_slice(data: &[u8; 16]) -> Self

Construct a GUID from 16 bytes.

let guid = guid_create::GUID::build_from_slice(&[
    0x87, 0x93, 0x5C, 0xDE, 0x70, 0x94, 0x4C, 0x2B, 0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D,
    0xD2, 0x61,
]);
assert_eq!(guid.data1(), 0x87935CDE);
assert_eq!(guid.data2(), 0x7094);
assert_eq!(guid.data3(), 0x4C2B);
assert_eq!(
    guid.data4(),
    [0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61]
);
assert_eq!(guid.to_string(), "87935CDE-7094-4C2B-A0F4-DD7D512DD261");

pub fn parse(guid: &str) -> Result<Self, ParseError>

Construct a GUID from a string.

let guid = guid_create::GUID::parse("87935CDE-7094-4C2B-A0F4-DD7D512DD261").unwrap();

assert_eq!(guid.data1(), 0x87935CDE);
assert_eq!(guid.data2(), 0x7094);
assert_eq!(guid.data3(), 0x4C2B);
assert_eq!(guid.data4(), [ 0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61 ]);
assert_eq!(guid.to_string(), "87935CDE-7094-4C2B-A0F4-DD7D512DD261");

pub fn rand() -> GUID

Generates a new GUID with 16 random bytes.

pub fn data1(&self) -> u32

The first four bytes.

extern crate guid_create;
let guid = guid_create::GUID::build_from_components(
    500,
    600,
    700,
    &[ 0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61 ]
);

assert_eq!(guid.data1(), 500);

pub fn data2(&self) -> u16

Bytes 5 and 6.

extern crate guid_create;
let guid = guid_create::GUID::build_from_components(
    500,
    600,
    700,
    &[ 0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61 ]
);

assert_eq!(guid.data2(), 600);

pub fn data3(&self) -> u16

Bytes 7 and 8.

extern crate guid_create;
let guid = guid_create::GUID::build_from_components(
    500,
    600,
    700,
    &[ 0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61 ]
);

assert_eq!(guid.data3(), 700);

pub fn data4(&self) -> [u8; 8]

The last eight bytes.

extern crate guid_create;
let guid = guid_create::GUID::build_from_components(
    500,
    600,
    700,
    &[ 0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61 ]
);

assert_eq!(
    guid.data4(),
    [0xA0, 0xF4, 0xDD, 0x7D, 0x51, 0x2D, 0xD2, 0x61]
);

Trait Implementations

impl Clone for GUID

fn clone(&self) -> GUID

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GUID

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

Formats the value using the given formatter.

impl Default for GUID

fn default() -> GUID

Returns the “default value” for a type.

impl Display for GUID

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

Formats the value using the given formatter.

impl Hash for GUID

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 GUID

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

impl Eq for GUID

impl StructuralPartialEq for GUID