#literals #syntax #macro #struct #windows #values

guid

A macro for writing Windows GUID values as convenient literals

1 unstable release

Uses old Rust 2015

0.1.0 Feb 12, 2018

#102 in #literals

Download history 23/week @ 2023-12-11 26/week @ 2023-12-18 16/week @ 2023-12-25 53/week @ 2024-01-01 34/week @ 2024-01-08 29/week @ 2024-01-15 13/week @ 2024-01-22 17/week @ 2024-01-29 29/week @ 2024-02-05 31/week @ 2024-02-12 41/week @ 2024-02-19 47/week @ 2024-02-26 47/week @ 2024-03-04 47/week @ 2024-03-11 47/week @ 2024-03-18 82/week @ 2024-03-25

227 downloads per month
Used in 2 crates (via winfolder)

MIT/Apache

18KB
265 lines

GUID

This crate provides a guid! macro for expressing GUID structs with a convenient literal syntax. A GUID is a Windows globally unique identifier, usually expressed in the following format:

{6B29FC40-CA47-1067-B31D-00DD010662DA}

With this crate, a GUID can be generated with the syntax:

guid!{"6B29FC40-CA47-1067-B31D-00DD010662DA"}

Example

#[macro_use]
extern crate guid;

use guid::GUID;

const MY_GUID: GUID = guid!{"6B29FC40-CA47-1067-B31D-00DD010662DA"};

fn main() {
    assert_eq!(MY_GUID.Data1, 0x6B29FC40);
    assert_eq!(MY_GUID.Data2, 0xCA47);
    assert_eq!(MY_GUID.Data3, 0x1067);
    assert_eq!(MY_GUID.Data4, [ 0xB3, 0x1D, 0x00, 0xDD, 0x01, 0x06, 0x62, 0xDA ]);
}

The GUID type is re-exported from the winapi crate, and is only available in Windows. The guid! macro is also only available in Windows.

This crate also provides a parser, which can be used to parse GUID strings at runtime. The parser is only available to generate an array of bytes on non-Windows platforms. In Windows, this crate defines a parser that produces a GUID struct.

Compatibility

This crate supports all versions of Rust (stable and nightly) starting with Rust 1.15.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~2.5MB
~55K SLoC