mirror of
https://github.com/boostorg/uuid.git
synced 2026-01-19 04:42:16 +00:00
a8a1ec3d82
operating-system provided entropy as it is more secure and faster for the typical use case of generating one uuid at a time. This is a breaking change for anyone passing a mt19937 into one of the explicit constructors of random_generator, which would be quite rare. Changed the default random provider on Windows to use BCrypt where available, falling back to Wincrypt when necessary or when explicitly requested through a macro. Provide a new random_generator_mt19937 type definition for use cases where a large number of uuids need to be created with high performance. This is equivalent to the previous definition of random_generator. Provide a random generation benchmark test showing the cutoff where the mt19937-based generator will outperform the standard generator based on wall time. Removed template specialization for boost::random::random_device so that any UniformRandomNumberGenerator can be used properly with random_generator. Replaced the seed_rng detail implementation (which had a number of flaws) with a replacement header-only random_provider implementation. Note: entropy generation errors will cause an entropy_error to be thrown from random_generator. The previous implementation ignored errors and silently failed. Added internal support for entropy generation on cloudabi platform leveraging the new random_provider implementation. Added internal support for Universal Windows Platform (UWP) development leveraging the new random_provider implementation. Added internal support for getentropy() on Linux and OpenBSD if certain requirements are met. This fixes #24 This closes #53
3.9 KiB
3.9 KiB
Uuid, part of collection of the Boost C++ Libraries, provides a C++ wrapper around RFC-4122 UUIDs.
License
Distributed under the Boost Software License, Version 1.0.
Properties
- C++03
- Header-only
Build Status
| Branch | Travis | Appveyor | Coverity Scan | codecov.io | Documentation | Regression Tests |
|---|---|---|---|---|---|---|
| master |  |
 |
 |
 |
 |
|
| develop |  |
 |
 |
 |
Directories
- doc - Dcumentation
- include - Interface headers of Uuid
- test - Uuid unit tests
More information
- Documentation
- Ask questions
- Report bugs: Be sure to mention Boost version, platform and compiler you're using. A small compilable code sample to reproduce the problem is always good as well.
- Submit your patches as pull requests against develop branch. Note that by submitting patches you agree to license your modifications under the Boost Software License, Version 1.0.
- Discussions about the library are held on the Boost developers mailing list. Be sure to read the discussion policy before posting and add the
[uuid]tag at the beginning of the subject line.
Code Example - UUID Generation
// Copyright 2017 James E. King III
// Distributed under the Boost Software License, Version 1.0.
// (See http://www.boost.org/LICENSE_1_0.txt)
// mkuuid.cpp example
#include <boost/lexical_cast.hpp>
#include <boost/uuid/random_generator.hpp>
#include <boost/uuid/uuid_io.hpp>
#include <iostream>
int main(void)
{
boost::uuids::random_generator gen;
std::cout << boost::lexical_cast<std::string>(gen()) << std::endl;
return 0;
}
----
$ clang++ -ansi -Wall -Wextra -std=c++03 -O3 mkuuid.cpp -o mkuuid
$ ./mkuuid
2c186eb0-89cf-4a3c-9b97-86db1670d5f4
$ ./mkuuid
a9d3fbb9-0383-4389-a8a8-61f6629f90b6