/rust/registry/src/index.crates.io-1949cf8c6b5b557f/uuid-1.8.0/src/v8.rs

Source
use crate::{Builder, Uuid};

impl Uuid {
    /// Creates a custom UUID comprised almost entirely of user-supplied bytes.
    ///
    /// This will inject the UUID Version at 4 bits starting at the 48th bit
    /// and the Variant into 2 bits 64th bit. Any existing bits in the user-supplied bytes
    /// at those locations will be overridden.
    ///
    /// Note that usage of this method requires the `v8` feature of this crate
    /// to be enabled.
    ///
    /// # Examples
    ///
    /// Basic usage:
    ///
    /// ```
    /// # use uuid::{Uuid, Version};
    /// let buf: [u8; 16] = *b"abcdefghijklmnop";
    /// let uuid = Uuid::new_v8(buf);
    ///
    /// assert_eq!(Some(Version::Custom), uuid.get_version());
    /// ```
    ///
    /// # References
    ///
    /// * [Version 8 UUIDs in Draft RFC: New UUID Formats, Version 4](https://datatracker.ietf.org/doc/html/draft-peabody-dispatch-new-uuid-format-04#section-5.3)
    pub fn new_v8(buf: [u8; 16]) -> Uuid {
        Builder::from_custom_bytes(buf).into_uuid()
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::{Variant, Version};
    use std::string::ToString;

    #[cfg(all(
        target_arch = "wasm32",
        target_vendor = "unknown",
        target_os = "unknown"
    ))]
    use wasm_bindgen_test::*;

    #[test]
    #[cfg_attr(
        all(
            target_arch = "wasm32",
            target_vendor = "unknown",
            target_os = "unknown"
        ),
        wasm_bindgen_test
    )]
    fn test_new() {
        let buf: [u8; 16] = [
            0xf, 0xe, 0xd, 0xc, 0xb, 0xa, 0x9, 0x8, 0x7, 0x6, 0x5, 0x4, 0x3, 0x2, 0x1, 0x0,
        ];
        let uuid = Uuid::new_v8(buf);
        assert_eq!(uuid.get_version(), Some(Version::Custom));
        assert_eq!(uuid.get_variant(), Variant::RFC4122);
        assert_eq!(uuid.get_version_num(), 8);
        assert_eq!(
            uuid.hyphenated().to_string(),
            "0f0e0d0c-0b0a-8908-8706-050403020100"
        );
    }
}

Coverage Report

Created: 2026-08-14 06:27

Line	Count	Source
1		use crate::{Builder, Uuid};
2
3		impl Uuid {
4		/// Creates a custom UUID comprised almost entirely of user-supplied bytes.
5		///
6		/// This will inject the UUID Version at 4 bits starting at the 48th bit
7		/// and the Variant into 2 bits 64th bit. Any existing bits in the user-supplied bytes
8		/// at those locations will be overridden.
9		///
10		/// Note that usage of this method requires the `v8` feature of this crate
11		/// to be enabled.
12		///
13		/// # Examples
14		///
15		/// Basic usage:
16		///
17		/// ```
18		/// # use uuid::{Uuid, Version};
19		/// let buf: [u8; 16] = *b"abcdefghijklmnop";
20		/// let uuid = Uuid::new_v8(buf);
21		///
22		/// assert_eq!(Some(Version::Custom), uuid.get_version());
23		/// ```
24		///
25		/// # References
26		///
27		/// * [Version 8 UUIDs in Draft RFC: New UUID Formats, Version 4](https://datatracker.ietf.org/doc/html/draft-peabody-dispatch-new-uuid-format-04#section-5.3)
28	0	pub fn new_v8(buf: [u8; 16]) -> Uuid {
29	0	Builder::from_custom_bytes(buf).into_uuid()
30	0	}
31		}
32
33		#[cfg(test)]
34		mod tests {
35		use super::*;
36		use crate::{Variant, Version};
37		use std::string::ToString;
38
39		#[cfg(all(
40		target_arch = "wasm32",
41		target_vendor = "unknown",
42		target_os = "unknown"
43		))]
44		use wasm_bindgen_test::*;
45
46		#[test]
47		#[cfg_attr(
48		all(
49		target_arch = "wasm32",
50		target_vendor = "unknown",
51		target_os = "unknown"
52		),
53		wasm_bindgen_test
54		)]
55		fn test_new() {
56		let buf: [u8; 16] = [
57		0xf, 0xe, 0xd, 0xc, 0xb, 0xa, 0x9, 0x8, 0x7, 0x6, 0x5, 0x4, 0x3, 0x2, 0x1, 0x0,
58		];
59		let uuid = Uuid::new_v8(buf);
60		assert_eq!(uuid.get_version(), Some(Version::Custom));
61		assert_eq!(uuid.get_variant(), Variant::RFC4122);
62		assert_eq!(uuid.get_version_num(), 8);
63		assert_eq!(
64		uuid.hyphenated().to_string(),
65		"0f0e0d0c-0b0a-8908-8706-050403020100"
66		);
67		}
68		}