Quick Start
You are viewing the master version of this library.
The master and develop pages are shown here to provide access to the newest in-development in-progress documentation. See the "Documentation" link on this page.
Other aspects of the page will reflect the previous official version, or not be available until the next release.
Boost.Uuid
Boost.Uuid, part of Boost C++ Libraries, provides a C++ implementation of Universally Unique Identifiers (UUID) as described in RFC 4122 and RFC 9562.
See the documentation for more information.
License
Distributed under the Boost Software License, Version 1.0.
Properties
- C++11 (since Boost 1.86.0)
- Header-only
Current Status
| Branch | Github Actions | Appveyor | Dependencies | Documentation | Test Matrix |
|---|---|---|---|---|---|
master |
 |
 |
 |
 |
|
develop |
 |
 |
 |
 |
More Information
- 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 the 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
// mkuuid.cpp example
#include <boost/uuid.hpp>
#include <iostream>
int main()
{
boost::uuids::random_generator gen;
std::cout << gen() << std::endl;
}
$ clang++ -Wall -Wextra -std=c++11 -O2 mkuuid.cpp -o mkuuid
$ ./mkuuid
2c186eb0-89cf-4a3c-9b97-86db1670d5f4
$ ./mkuuid
a9d3fbb9-0383-4389-a8a8-61f6629f90b6
<h1>Boost.Uuid</h1> <p>Boost.Uuid, part of <a href="http://boost.org">Boost C++ Libraries</a>, provides a C++ implementation of Universally Unique Identifiers (UUID) as described in <a href="https://datatracker.ietf.org/doc/rfc4122/">RFC 4122</a> and <a href="https://datatracker.ietf.org/doc/rfc9562/">RFC 9562</a>.</p> <p>See <a href="http://boost.org/libs/uuid">the documentation</a> for more information.</p> <h2>License</h2> <p>Distributed under the <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</p> <h2>Properties</h2> <ul> <li>C++11 (since Boost 1.86.0)</li> <li>Header-only</li> </ul> <h2>Current Status</h2> <table> <thead> <tr> <th align="center">Branch</th> <th align="left">Github Actions</th> <th align="left">Appveyor</th> <th align="left">Dependencies</th> <th align="left">Documentation</th> <th align="left">Test Matrix</th> </tr> </thead> <tbody> <tr> <td align="center"><a href="https://github.com/boostorg/uuid/tree/master"><code>master</code></a></td> <td align="left"><a href="https://github.com/boostorg/uuid/actions?query=branch:master"><img src="https://github.com/boostorg/uuid/actions/workflows/ci.yml/badge.svg?branch=master" alt="Build Status" /></a></td> <td align="left"><a href="https://ci.appveyor.com/project/cppalliance/uuid/branch/master"><img src="https://ci.appveyor.com/api/projects/status/rmp9xmse2b6urkjv/branch/master?svg=true" alt="Build status" /></a></td> <td align="left"><a href="https://pdimov.github.io/boostdep-report/master/uuid.html"><img src="https://img.shields.io/badge/deps-master-brightgreen.svg" alt="Deps" /></a></td> <td align="left"><a href="http://www.boost.org/doc/libs/master/doc/html/uuid.html"><img src="https://img.shields.io/badge/docs-master-brightgreen.svg" alt="Documentation" /></a></td> <td align="left"><a href="https://regression.boost.io/master/developer/uuid.html"><img src="https://img.shields.io/badge/matrix-master-brightgreen.svg" alt="Enter the Matrix" /></a></td> </tr> <tr> <td align="center"><a href="https://github.com/boostorg/uuid/tree/develop"><code>develop</code></a></td> <td align="left"><a href="https://github.com/boostorg/uuid/actions?query=branch:develop"><img src="https://github.com/boostorg/uuid/actions/workflows/ci.yml/badge.svg?branch=develop" alt="Build Status" /></a></td> <td align="left"><a href="https://ci.appveyor.com/project/cppalliance/uuid/branch/develop"><img src="https://ci.appveyor.com/api/projects/status/rmp9xmse2b6urkjv/branch/develop?svg=true" alt="Build status" /></a></td> <td align="left"><a href="https://pdimov.github.io/boostdep-report/develop/uuid.html"><img src="https://img.shields.io/badge/deps-develop-brightgreen.svg" alt="Deps" /></a></td> <td align="left"><a href="http://www.boost.org/doc/libs/develop/doc/html/uuid.html"><img src="https://img.shields.io/badge/docs-develop-brightgreen.svg" alt="Documentation" /></a></td> <td align="left"><a href="https://regression.boost.io/develop/developer/uuid.html"><img src="https://img.shields.io/badge/matrix-develop-brightgreen.svg" alt="Enter the Matrix" /></a></td> </tr> </tbody> </table> <h2>More Information</h2> <ul> <li><a href="http://stackoverflow.com/questions/ask?tags=c%2B%2B,boost,boost-uuid">Ask questions</a></li> <li><a href="https://github.com/boostorg/uuid/issues">Report bugs</a>: 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.</li> <li>Submit your patches as pull requests against the <strong>develop</strong> branch. Note that by submitting patches you agree to license your modifications under the <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</li> <li>Discussions about the library are held on the <a href="http://www.boost.org/community/groups.html#main">Boost developers mailing list</a>. Be sure to read the <a href="http://www.boost.org/community/policy.html">discussion policy</a> before posting and add the <code>[uuid]</code> tag at the beginning of the subject line.</li> </ul> <h2>Code Example - UUID Generation</h2> <pre class="highlightjs highlight"><code class="language-cpp hljs">// mkuuid.cpp example #include <boost/uuid.hpp> #include <iostream> int main() { boost::uuids::random_generator gen; std::cout << gen() << std::endl; } </code></pre> <pre class="highlightjs highlight"><code class="language-shell hljs">$ clang++ -Wall -Wextra -std=c++11 -O2 mkuuid.cpp -o mkuuid $ ./mkuuid 2c186eb0-89cf-4a3c-9b97-86db1670d5f4 $ ./mkuuid a9d3fbb9-0383-4389-a8a8-61f6629f90b6 </code></pre>
-
Code Commits Commits authored to any Boost repository. With 1 contribution, you will earn the bronze badge for Code Commits.
-
Documentation Doc contributions using standardised Boost tooling (Antora / BoostLook). With 1 contribution, you will earn the bronze badge for Documentation.
-
Library Authoring Authored an original Boost library accepted into the collection. With 1 contribution, you will earn the bronze badge for Library Authoring.
-
Library Maintenance Number of libraries actively maintained. With 1 contribution, you will earn the bronze badge for Library Maintenance.
-
Library Review Formal review submissions on Boost proposals. With 1 contribution, you will earn the bronze badge for Library Review.
-
Library Versioning Authored new versions / releases of Boost libraries. With 10 contributions, you will earn the bronze badge for Library Versioning.
-
Mailing List Participation Participation on the Boost developers mailing list. With 1 contribution, you will earn the bronze badge for Mailing List Participation.
-
News Posts Published Articles / news posts published on Boost.org. With 1 contribution, you will earn the bronze badge for News Posts Published.
<h1>Boost.Uuid</h1> <p>Boost.Uuid, part of <a href="http://boost.org">Boost C++ Libraries</a>, provides a C++ implementation of Universally Unique Identifiers (UUID) as described in <a href="https://datatracker.ietf.org/doc/rfc4122/">RFC 4122</a> and <a href="https://datatracker.ietf.org/doc/rfc9562/">RFC 9562</a>.</p> <p>See <a href="http://boost.org/libs/uuid">the documentation</a> for more information.</p> <h2>License</h2> <p>Distributed under the <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</p> <h2>Properties</h2> <ul> <li>C++11 (since Boost 1.86.0)</li> <li>Header-only</li> </ul> <h2>Current Status</h2> <table> <thead> <tr> <th align="center">Branch</th> <th align="left">Github Actions</th> <th align="left">Appveyor</th> <th align="left">Dependencies</th> <th align="left">Documentation</th> <th align="left">Test Matrix</th> </tr> </thead> <tbody> <tr> <td align="center"><a href="https://github.com/boostorg/uuid/tree/master"><code>master</code></a></td> <td align="left"><a href="https://github.com/boostorg/uuid/actions?query=branch:master"><img src="https://github.com/boostorg/uuid/actions/workflows/ci.yml/badge.svg?branch=master" alt="Build Status" /></a></td> <td align="left"><a href="https://ci.appveyor.com/project/cppalliance/uuid/branch/master"><img src="https://ci.appveyor.com/api/projects/status/rmp9xmse2b6urkjv/branch/master?svg=true" alt="Build status" /></a></td> <td align="left"><a href="https://pdimov.github.io/boostdep-report/master/uuid.html"><img src="https://img.shields.io/badge/deps-master-brightgreen.svg" alt="Deps" /></a></td> <td align="left"><a href="http://www.boost.org/doc/libs/master/doc/html/uuid.html"><img src="https://img.shields.io/badge/docs-master-brightgreen.svg" alt="Documentation" /></a></td> <td align="left"><a href="https://regression.boost.io/master/developer/uuid.html"><img src="https://img.shields.io/badge/matrix-master-brightgreen.svg" alt="Enter the Matrix" /></a></td> </tr> <tr> <td align="center"><a href="https://github.com/boostorg/uuid/tree/develop"><code>develop</code></a></td> <td align="left"><a href="https://github.com/boostorg/uuid/actions?query=branch:develop"><img src="https://github.com/boostorg/uuid/actions/workflows/ci.yml/badge.svg?branch=develop" alt="Build Status" /></a></td> <td align="left"><a href="https://ci.appveyor.com/project/cppalliance/uuid/branch/develop"><img src="https://ci.appveyor.com/api/projects/status/rmp9xmse2b6urkjv/branch/develop?svg=true" alt="Build status" /></a></td> <td align="left"><a href="https://pdimov.github.io/boostdep-report/develop/uuid.html"><img src="https://img.shields.io/badge/deps-develop-brightgreen.svg" alt="Deps" /></a></td> <td align="left"><a href="http://www.boost.org/doc/libs/develop/doc/html/uuid.html"><img src="https://img.shields.io/badge/docs-develop-brightgreen.svg" alt="Documentation" /></a></td> <td align="left"><a href="https://regression.boost.io/develop/developer/uuid.html"><img src="https://img.shields.io/badge/matrix-develop-brightgreen.svg" alt="Enter the Matrix" /></a></td> </tr> </tbody> </table> <h2>More Information</h2> <ul> <li><a href="http://stackoverflow.com/questions/ask?tags=c%2B%2B,boost,boost-uuid">Ask questions</a></li> <li><a href="https://github.com/boostorg/uuid/issues">Report bugs</a>: 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.</li> <li>Submit your patches as pull requests against the <strong>develop</strong> branch. Note that by submitting patches you agree to license your modifications under the <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</li> <li>Discussions about the library are held on the <a href="http://www.boost.org/community/groups.html#main">Boost developers mailing list</a>. Be sure to read the <a href="http://www.boost.org/community/policy.html">discussion policy</a> before posting and add the <code>[uuid]</code> tag at the beginning of the subject line.</li> </ul> <h2>Code Example - UUID Generation</h2> <pre class="highlightjs highlight"><code class="language-cpp hljs">// mkuuid.cpp example #include <boost/uuid.hpp> #include <iostream> int main() { boost::uuids::random_generator gen; std::cout << gen() << std::endl; } </code></pre> <pre class="highlightjs highlight"><code class="language-shell hljs">$ clang++ -Wall -Wextra -std=c++11 -O2 mkuuid.cpp -o mkuuid $ ./mkuuid 2c186eb0-89cf-4a3c-9b97-86db1670d5f4 $ ./mkuuid a9d3fbb9-0383-4389-a8a8-61f6629f90b6 </code></pre>
-
Achievement-based Reflects the depth of your contributions. Accumulate achievements to unlock five tiers; Bronze, Silver, Gold, Platinum and Diamond.
-
Tenure-based Awarded in recognition of your time on the platform. The longer you've been part of the Boost community, the higher the tier you unlock.
-
Boost day celebration A celebration of the day you joined Boost. Awarded annually to mark another year as part of the community.
