stduuid 使用指南：从入门到精通

stduuid 使用指南：从入门到精通

【免费下载链接】stduuidA C++17 cross-platform implementation for UUIDs项目地址: https://gitcode.com/gh_mirrors/st/stduuid

stduuid 是一个基于 C++17 的跨平台单头文件库，专门用于生成和处理通用唯一标识符（UUID）。UUID 是 128 位的数字，广泛应用于数据库表键、COM 接口、类和类型库等场景，确保信息的全局唯一性。

项目概述

stduuid 库提供了完整的 UUID 生成和管理功能，支持多种 UUID 版本和生成策略。虽然规范建议将 uuid 库放在std命名空间中，但此实现使用uuids命名空间，以避免违反std命名空间的限制。

核心功能特性

基础类型

• uuid：表示 UUID 的类，支持默认构造（nil UUID）、从范围（由迭代器对定义）构造或从span构造
• uuid_variant：强类型枚举，表示 UUID 的变体类型
• uuid_version：强类型枚举，表示 UUID 的版本

生成器类型

• basic_uuid_random_generator：函数对象，使用伪随机数生成器引擎生成版本 4 的 UUID
• uuid_random_generator：使用 Mersenne Twister 引擎的随机生成器
• uuid_name_generator：函数对象，使用 SHA1 哈希生成版本 5、基于名称的 UUID
• uuid_system_generator：使用操作系统资源生成新 UUID 的函数对象

实用工具

• std::swap<>：为uuid特化的交换函数
• std::hash<>：为uuid特化的哈希函数

快速入门示例

创建 nil UUID

uuid empty; assert(empty.is_nil());

创建新 UUID

uuid const id = uuids::uuid_system_generator{}(); assert(!id.is_nil()); assert(id.version() == uuids::uuid_version::random_number_based); assert(id.variant() == uuids::uuid_variant::rfc);

使用默认随机生成器创建 UUID

std::random_device rd; auto seed_data = std::array<int, std::mt19937::state_size> {}; std::generate(std::begin(seed_data), std::end(seed_data), std::ref(rd)); std::seed_seq seq(std::begin(seed_data), std::end(seed_data)); std::mt19937 generator(seq); uuids::uuid_random_generator gen{generator}; uuid const id = gen(); assert(!id.is_nil()); assert(id.as_bytes().size() == 16); assert(id.version() == uuids::uuid_version::random_number_based); assert(id.variant() == uuids::uuid_variant::rfc);

从字符串创建 UUID

auto str = "47183823-2574-4bfd-b411-99ed177d3e43"s; auto id = uuids::uuid::from_string(str); assert(id.has_value()); assert(uuids::to_string(id.value()) == str);

构建指南

Windows 平台

1. 创建名为build的文件夹
2. 从build文件夹运行 CMake 命令生成项目文件
3. 使用适当的生成器（如 "Visual Studio 15 2017" 针对 x86）

Mac 平台

1. 创建名为build的文件夹
2. 从build文件夹运行 CMake 命令

常见问题解决方案

头文件引用问题

确保uuid.h文件存在于项目的include目录中，并在代码中正确包含头文件：

#include "uuid.h"

随机数生成器初始化

在使用uuid_random_generator生成 UUID 时，确保随机数生成器已正确初始化：

std::random_device rd; std::mt19937 gen(rd()); uuids::uuid_random_generator generator(&gen);

UUID 版本验证

生成 UUID 后，可以通过id.version()方法验证 UUID 的版本：

if (id.version() == uuids::uuid_version::random_number_based) { // 版本 4 的 UUID }

高级用法

在有序关联容器中使用

std::random_device rd; auto seed_data = std::array<int, std::mt19937::state_size> {}; std::generate(std::begin(seed_data), std::end(seed_data), std::ref(rd)); std::seed_seq seq(std::begin(seed_data), std::end(seed_data)); std::mt19937 engine(seq); uuids::uuid_random_generator gen(&engine); std::set<uuids::uuid> ids{uuid{}, gen(), gen(), gen(), gen()}; assert(ids.size() == 5);

在无序关联容器中使用

std::unordered_set<uuids::uuid> ids{uuid{}, gen(), gen(), gen(), gen()}; assert(ids.size() == 5);

依赖管理

如果项目使用 C++20 构建，则可以使用std::span。如果不支持 C++20，库默认使用 Microsoft Guidelines Support Library (GSL) 的span实现。确保 GSL 库可用，并且 GSL 包含目录在项目的包含目录列表中。

测试支持

项目中包含测试项目，可以通过以下步骤构建和执行测试：

1. 克隆或下载此仓库
2. 在源代码根目录中创建build目录
3. 从build目录运行cmake ..命令
4. 构建前一步创建的项目
5. 运行可执行文件

stduuid 库为 C++ 开发者提供了简单、高效且跨平台的 UUID 解决方案，无论是简单的标识符生成还是复杂的分布式系统应用，都能满足需求。

【免费下载链接】stduuidA C++17 cross-platform implementation for UUIDs项目地址: https://gitcode.com/gh_mirrors/st/stduuid