• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Uuid, part of collection of the [Boost C++ Libraries](http://github.com/boostorg), provides a C++ wrapper around [RFC-4122](http://www.ietf.org/rfc/rfc4122.txt) UUIDs.
2
3### License
4
5Distributed under the [Boost Software License, Version 1.0](https://www.boost.org/LICENSE_1_0.txt).
6
7### Properties
8
9* C++03
10* Header-only
11
12### Build Status
13
14Branch          | Travis | Appveyor | Coverity Scan | codecov.io | Deps | Docs | Tests |
15:-------------: | ------ | -------- | ------------- | ---------- | ---- | ---- | ----- |
16[`master`](https://github.com/boostorg/uuid/tree/master) | [![Build Status](https://travis-ci.org/boostorg/uuid.svg?branch=master)](https://travis-ci.org/boostorg/uuid) | [![Build status](https://ci.appveyor.com/api/projects/status/nuihr6s92fjb9gwy/branch/master?svg=true)](https://ci.appveyor.com/project/jeking3/uuid-gaamf/branch/master) | [![Coverity Scan Build Status](https://scan.coverity.com/projects/13982/badge.svg)](https://scan.coverity.com/projects/boostorg-uuid) | [![codecov](https://codecov.io/gh/boostorg/uuid/branch/master/graph/badge.svg)](https://codecov.io/gh/boostorg/uuid/branch/master)| [![Deps](https://img.shields.io/badge/deps-master-brightgreen.svg)](https://pdimov.github.io/boostdep-report/master/uuid.html) | [![Documentation](https://img.shields.io/badge/docs-master-brightgreen.svg)](http://www.boost.org/doc/libs/master/doc/html/uuid.html) | [![Enter the Matrix](https://img.shields.io/badge/matrix-master-brightgreen.svg)](http://www.boost.org/development/tests/master/developer/uuid.html)
17[`develop`](https://github.com/boostorg/uuid/tree/develop) | [![Build Status](https://travis-ci.org/boostorg/uuid.svg?branch=develop)](https://travis-ci.org/boostorg/uuid) | [![Build status](https://ci.appveyor.com/api/projects/status/nuihr6s92fjb9gwy/branch/develop?svg=true)](https://ci.appveyor.com/project/jeking3/uuid-gaamf/branch/develop) | [![Coverity Scan Build Status](https://scan.coverity.com/projects/13982/badge.svg)](https://scan.coverity.com/projects/boostorg-uuid) | [![codecov](https://codecov.io/gh/boostorg/uuid/branch/develop/graph/badge.svg)](https://codecov.io/gh/boostorg/uuid/branch/develop) | [![Deps](https://img.shields.io/badge/deps-develop-brightgreen.svg)](https://pdimov.github.io/boostdep-report/develop/uuid.html) | [![Documentation](https://img.shields.io/badge/docs-develop-brightgreen.svg)](http://www.boost.org/doc/libs/develop/doc/html/uuid.html) | [![Enter the Matrix](https://img.shields.io/badge/matrix-develop-brightgreen.svg)](http://www.boost.org/development/tests/develop/developer/uuid.html)
18
19### Directories
20
21| Name        | Purpose                        |
22| ----------- | ------------------------------ |
23| `doc`       | documentation                  |
24| `include`   | headers                        |
25| `test`      | unit tests                     |
26
27### More information
28
29* [Ask questions](http://stackoverflow.com/questions/ask?tags=c%2B%2B,boost,boost-uuid)
30* [Report bugs](https://github.com/boostorg/uuid/issues): 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.
31* 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](https://www.boost.org/LICENSE_1_0.txt).
32* Discussions about the library are held on the [Boost developers mailing list](http://www.boost.org/community/groups.html#main). Be sure to read the [discussion policy](http://www.boost.org/community/policy.html) before posting and add the `[uuid]` tag at the beginning of the subject line.
33
34### Code Example - UUID Generation
35
36    // Copyright 2017 James E. King III
37    // Distributed under the Boost Software License, Version 1.0.
38    // (See https://www.boost.org/LICENSE_1_0.txt)
39    //  mkuuid.cpp example
40
41    #include <boost/lexical_cast.hpp>
42    #include <boost/uuid/random_generator.hpp>
43    #include <boost/uuid/uuid_io.hpp>
44    #include <iostream>
45
46    int main(void)
47    {
48        boost::uuids::random_generator gen;
49        std::cout << boost::lexical_cast<std::string>(gen()) << std::endl;
50        return 0;
51    }
52
53    ----
54
55    $ clang++ -ansi -Wall -Wextra -std=c++03 -O3 mkuuid.cpp -o mkuuid
56    $ ./mkuuid
57    2c186eb0-89cf-4a3c-9b97-86db1670d5f4
58    $ ./mkuuid
59    a9d3fbb9-0383-4389-a8a8-61f6629f90b6
60
61
62