[][src]Crate uuid

Generate and parse UUIDs.

Provides support for Universally Unique Identifiers (UUIDs). A UUID is a unique 128-bit number, stored as 16 octets. UUIDs are used to assign unique identifiers to entities without requiring a central allocating authority.

They are particularly useful in distributed systems, though can be used in disparate areas, such as databases and network protocols. Typically a UUID is displayed in a readable string form as a sequence of hexadecimal digits, separated into groups by hyphens.

The uniqueness property is not strictly guaranteed, however for all practical purposes, it can be assumed that an unintentional collision would be extremely unlikely.

Dependencies

By default, this crate depends on nothing but std and cannot generate UUIDs. You need to enable the following Cargo features to enable various pieces of functionality:

You need to enable one of the following Cargo features together with v3, v4 or v5 feature if you're targeting wasm32 architecture:

By default, uuid can be depended on with:

[dependencies]
uuid = "0.8"

To activate various features, use syntax like:

[dependencies]
uuid = { version = "0.8", features = ["serde", "v4"] }

You can disable default features with:

[dependencies]
uuid = { version = "0.8", default-features = false }

Examples

To parse a UUID given in the simple format and print it as a urn:

use uuid::Uuid;

fn main() {
    let my_uuid =
        Uuid::parse_str("936DA01F9ABD4d9d80C702AF85C822A8").unwrap();
    println!("{}", my_uuid.to_urn());
}

To create a new random (V4) UUID and print it out in hexadecimal form:

This example is not tested
// Note that this requires the `v4` feature enabled in the uuid crate.

use uuid::Uuid;

fn main() {
    let my_uuid = Uuid::new_v4();
    println!("{}", my_uuid);
}

Strings

Examples of string representations:

References

Re-exports

pub use crate::builder::Builder;
pub use crate::error::Error;

Modules

adapter

Adapters for various formats for UUIDs

builder

A Builder type for Uuids.

error
parser

Uuid parsing constructs and utilities.

prelude

The uuid prelude.

Structs

Uuid

A Universally Unique Identifier (UUID).

Enums

Variant

The reserved variants of UUIDs.

Version

The version of the UUID, denoting the generating algorithm.

Type Definitions

Bytes

A 128-bit (16 byte) buffer containing the ID.