uuid.hpp

#pragma once

// std
#include <array>
#include <iosfwd>
#include <string>

namespace util {

    /// following rfc4122 (https://datatracker.ietf.org/doc/html/rfc4122):
    ///
    ///  0                   1                   2                   3
    ///  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
    /// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    /// |                          time_low                             | (a)
    /// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    /// |       time_mid                |         time_hi_and_version   | (b, c)
    /// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    /// |clk_seq_hi_res |  clk_seq_low  |         node (0-1)            | (d, e, f)
    /// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    /// |                         node (2-5)                            | (g)
    /// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    ///
    /// data is stored big-endian; string output is in standard grouped
    /// format:
    ///
    /// aaaaaaaa-bbbb-cccc-ddee-ffffgggggggg
    struct uuid
    {
        std::array<char, 16> data = {};

        uint32_t time_low() const;
        uint16_t time_mid() const;
        uint16_t time_hi_version() const;
        uint8_t clock_seq_hi_reserved() const;
        uint8_t clock_seq_low() const;
        uint64_t node() const;                 ///< only low 48 bits are set

        static uuid create_v4();
        std::string to_string() const;
    };
}


std::ostream& operator<<(std::ostream&, const util::uuid&);