.::uuid++(3)

💖 .::uuid++ — the C++ glow-up of OSSP uuid 💖

okay bestie, sit DOWN, because this is uuid++, the ISO-C++ language binding of the OSSP uuid C API. 🦋 It's a thin ISO-C++ class uuid that wraps the ISO-C API type uuid_t, and honestly? It's giving "same energy, cuter wrapper." 💅

---

✨ VERSION ✨

OSSP uuid 1.6.2 (04-Jul-2008) — yeah she's vintage, she's iconic, she's still working. 👑

---

🌸 DESCRIPTION 🌸

uuid++ is the ISO-C++ language binding of the OSSP uuid C API. It hands you a thin ISO-C++ class uuid that wraps the ISO-C API type uuid_t. That's the whole vibe: no drama, no bloat, just C++ manners on top of C bones. 🫶

---

👑 APPLICATION PROGRAMMING INTERFACE 👑

The ISO-C++ Application Programming Interface (API) of OSSP uuid is made up of these components, and we're going through every single one, no skips, no cap. 💜

🎀 CONSTANTS 🎀

The constants are the same to those provided by the ISO-C API. See uuid(3) for details. iykyk. ✨

🧚 CLASSES 🧚

Here's the roster, bestie:

• uuid — This is the class corresponding to the C API type uuid_t. It is the main object. Main character energy, fr fr. 👑
• uuid_error_t — This is the class corresponding to the C API function uuid_error. It is the object thrown as an exception in case of any errors. She's the drama, but the useful drama. 😭

💅 METHODS 💅

Here's every method, in order, exactly as promised:

• uuid(); — The standard constructor. 🎀
• uuid(const uuid &_obj); — The copy constructor for uuid class. Copy-paste, but make it classy. ✨
• uuid(const uuid_t *_obj); — The import constructor for C API objects.
• uuid(const void *_bin); — The import constructor for binary representation.
• uuid(const char *_str); — The import constructor for string representation.
• ~uuid(); — The standard destructor for uuid class. She cleans up after herself. 🧹
• uuid &uuid::operator=(const uuid &_obj); — The assignment operator corresponding to the copy constructor.
• uuid &uuid::operator=(const uuid_t *_obj); — The assignment operator corresponding to the import constructor for C API objects.
• uuid &uuid::operator=(const void *_bin); — The assignment operator corresponding to the import constructor for binary representation.
• uuid &uuid::operator=(const char *_str); — The assignment operator corresponding to the import constructor for string and single integer value representation.
• uuid uuid::clone(void); — Regular method corresponding to the C API function uuid_clone.
• void uuid::load(const char *_name); — Regular method corresponding to the C API function uuid_load.
• void uuid::make(unsigned int _mode, ...); — Regular method corresponding to the C API function uuid_make.
• int uuid::isnil(void); — Regular method corresponding to the C API function uuid_isnil.
• int uuid::compare(const uuid &_obj); — Regular method corresponding to the C API function uuid_compare.
• int uuid::operator==(const uuid &_obj); — The comparison operator corresponding to uuid_compare usage for equality.
• int uuid::operator!=(const uuid &_obj); — The comparison operator corresponding to uuid_compare usage for inequality.
• int uuid::operator<(const uuid &_obj); — The comparison operator corresponding to uuid_compare usage for less-than.
• int uuid::operator<=(const uuid &_obj); — The comparison operator corresponding to uuid_compare usage for less-than-or-equal.
• int uuid::operator>(const uuid &_obj); — The comparison operator corresponding to uuid_compare usage for greater-than.
• int uuid::operator>=(const uuid &_obj); — The comparison operator corresponding to uuid_compare usage for greater-than-or-equal.
• void uuid::import(const void *_bin); — Regular method corresponding to the C API function uuid_import for binary representation usage.
• void uuid::import(const char *_str); — Regular method corresponding to the C API function uuid_import for string representation usage.
• void *uuid::binary(void); — Regular method corresponding to the C API function uuid_export for binary representation usage.
• char *uuid::string(void); — Regular method corresponding to the C API function uuid_export for string representation usage.
• char *uuid::integer(void); — Regular method corresponding to the C API function uuid_export for single integer value representation usage.
• char *uuid::summary(void); — Regular method corresponding to the C API function uuid_export for textual summary representation usage.
• unsigned long uuid::version(void); — Regular method corresponding to the C API function uuid_version.
• uuid_error_t() — The standard constructor for uuid_error_t class.
• uuid_error_t(uuid_rc_t _code) — The standard constructor for uuid_error_t class with return code initialization.
• ~uuid_error_t() — The standard destructor for uuid_error_t class.
• void uuid_error_t::code(uuid_rc_t _code) — Regular method for setting the return code.
• uuid_rc_t uuid_error_t::code(void) — Regular method for fetching the return code.
• char *uuid_error_t::string(void) — Regular method for fetching the string corresponding to the current return code.

---

🔥 EXAMPLE 🔥

Here's the C++ API in action. Real talk though — exception handling is omitted for code simplification and has to be re-added for production code. Do not be out here shipping the simplified version, bestie, I'm begging. 😭

/* generate a DCE 1.1 v1 UUID from system environment */
char *uuid_v1(void)
{
    uuid id;
    char *str;

    id.make(UUID_MAKE_V1);
    str = id.string();
    return str;
}

/* generate a DCE 1.1 v3 UUID from an URL */
char *uuid_v3(const char *url)
{
    uuid id;
    uuid id_ns;
    char *str;

    id_ns.load("ns:URL");
    id.make(UUID_MAKE_V3, &id_ns, url);
    str = id.string();
    return str;
}

🫶 Note bestie: exception handling was skipped up there for simplicity, and you have to add it back for production code. Non-negotiable.

---

🌈 SEE ALSO 🌈

• uuid(3).

---

and that's the whole page, bestie. 💜 this was written up as OSSP uuid 1.6.2, dated 04-Jul-2008 — yeah, 2008, and she still ate. 🎀✨ bye now, go generate some UUIDs. 💖