QUuid(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

✨ QUuid ✨

okay bestie, so this is the QUuid(3qt) manual page, aka the glow-up doc for the class that defines a Universally Unique Identifier (UUID) 💖

🌸 NAME 🌸

QUuid — Defines a Universally Unique Identifier (UUID)

🎀 SYNOPSIS 🎀

heads up bestie: All the functions in this class are reentrant when Qt is built with thread support. 💅
#include <quuid.h>

👑 Public Members 👑

enum Variant { VarUnknown = -1, NCS = 0, DCE = 2, Microsoft = 6,
    Reserved = 7 }
enum Version { VerUnknown = -1, Time = 1, EmbeddedPOSIX = 2, Name = 3,
    Random = 4 }
QUuid ()
QUuid ( uint l, ushort w1, ushort w2, uchar b1, uchar b2, uchar b3,
    uchar b4, uchar b5, uchar b6, uchar b7, uchar b8 )
QUuid ( const QUuid & orig )
QUuid ( const QString & text )
QString toString () const
operator QString () const
bool isNull () const
QUuid & operator= ( const QUuid & uuid )
bool operator== ( const QUuid & other ) const
bool operator!= ( const QUuid & other ) const
bool operator< ( const QUuid & other ) const
bool operator> ( const QUuid & other ) const
QUuid::Variant variant () const
QUuid::Version version () const

⭐ Static Public Members ⭐

QUuid createUuid ()
QDataStream & operator<< ( QDataStream & s, const QUuid & id )
QDataStream & operator>> ( QDataStream & s, QUuid & id )

💜 DESCRIPTION 💜

The QUuid class defines a Universally Unique Identifier (UUID).

So like, when you've got objects or declarations that must be uniquely identified, UUIDs (aka GUIDs, same vibe different name 💫) are what everyone reaches for, because they give you a fixed value that's easy to compare and slap onto whatever needs it. The 128-bit value of a UUID comes out of an algorithm that guarantees the value is unique. no cap.

In Qt, UUIDs are wrapped by the QUuid struct, which comes with convenience functions for handling UUIDs. Most platforms give you a tool to generate new UUIDs, for example, uuidgen and guidgen. 🛠️

UUIDs generated by QUuid are based on the Random version of the DCE (Distributed Computing Environment) standard.

You can construct UUIDs from numeric values or from strings, or you can use the static createUuid() function. Then you can convert them to a string with toString(). UUIDs have a variant() and a version(), and null UUIDs return TRUE from isNull(). ✨

🧚 Member Type Documentation 🧚

QUuid::Variant

This enum defines the variant of the UUID, which is the scheme that defines the layout of the 128-bits value. iykyk.

  • QUuid::VarUnknown — Variant is unknown 🙈
  • QUuid::NCS — Reserved for NCS (Network Computing System) backward compatibility
  • QUuid::DCE — Distributed Computing Environment, the scheme used by QUuid 💅
  • QUuid::Microsoft — Reserved for Microsoft backward compatibility (GUID)
  • QUuid::Reserved — Reserved for future definition 🔮

QUuid::Version

This enum defines the version of the UUID.

  • QUuid::VerUnknown — Version is unknown 🙈
  • QUuid::Time — Time-based, by using timestamp, clock sequence, and MAC network card address (if available) for the node sections ⏰
  • QUuid::EmbeddedPOSIX — DCE Security version, with embedded POSIX UUIDs
  • QUuid::Name — Name-based, by using values from a name for all sections
  • QUuid::Random — Random-based, by using random numbers for all sections 🎲

💖 MEMBER FUNCTION DOCUMENTATION 💖

QUuid::QUuid ()

Creates the null UUID {00000000-0000-0000-0000-000000000000}. it's giving ✨nothing✨ but like, on purpose.

QUuid::QUuid ( uint l, ushort w1, ushort w2, uchar b1, uchar b2, uchar b3, uchar b4, uchar b5, uchar b6, uchar b7, uchar b8 )

Creates a UUID with the value specified by the parameters, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8. bestie that's a LOT of parameters and every single one matters 💅

Example:

// {67C8770B-44F1-410A-AB9A-F9B5446F13EE}
QUuid IID_MyInterface( 0x67c8770b, 0x44f1, 0x410a, 0xab, 0x9a, 0xf9, 0xb5, 0x44, 0x6f, 0x13, 0xee )

QUuid::QUuid ( const QUuid & orig )

Creates a copy of the QUuid orig. twin behaviour, obsessed. 🫶

QUuid::QUuid ( const QString & text )

Creates a QUuid object from the string text. The function can only convert a string in the format {HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} (where 'H' stands for a hex digit). If the conversion fails a null UUID is created. 😭

QUuid QUuid::createUuid () [static]

Returns a new UUID of DCE variant, and Random type. The UUIDs generated are based on the platform specific pseudo-random generator, which is usually not a cryptographic-quality random number generator. Therefore, a UUID is not guaranteed to be unique cross application instances.

lowkey important: that pseudo-random thing means no cryptographic-quality randomness, and uniqueness across application instances isn't guaranteed. fr fr.

On Windows, the new UUID is extremely likely to be unique on the same or any other system, networked or not. 🪟✨

See also variant() and version().

bool QUuid::isNull () const

Returns TRUE if this is the null UUID {00000000-0000-0000-0000-000000000000}; otherwise returns FALSE.

QUuid::operator QString () const

Returns the string representation of the uuid.

See also toString().

bool QUuid::operator!= ( const QUuid & other ) const

Returns TRUE if this QUuid and the other QUuid are different; otherwise returns FALSE. not the same, periodt. 💀

bool QUuid::operator< ( const QUuid & other ) const

Returns TRUE if this QUuid is of the same variant, and lexicographically before the other QUuid; otherwise returns FALSE.

See also variant().

QUuid & QUuid::operator= ( const QUuid & uuid )

Assigns the value of uuid to this QUuid object.

bool QUuid::operator== ( const QUuid & other ) const

Returns TRUE if this QUuid and the other QUuid are identical; otherwise returns FALSE. 💞

bool QUuid::operator> ( const QUuid & other ) const

Returns TRUE if this QUuid is of the same variant, and lexicographically after the other QUuid; otherwise returns FALSE.

See also variant().

QString QUuid::toString () const

QString QUuid::toString() const

Returns the string representation of the uuid.

QUuid::Variant QUuid::variant () const

Returns the variant of the UUID. The null UUID is considered to be of an unknown variant. 🙈

See also version().

QUuid::Version QUuid::version () const

Returns the version of the UUID, if the UUID is of the DCE variant; otherwise returns VerUnknown.

See also variant().

QDataStream & operator<< ( QDataStream & s, const QUuid & id )

Writes the uuid id to the datastream s. 📤

QDataStream & operator>> ( QDataStream & s, QUuid & id )

Reads uuid from from the stream s into id. 📥

(and yes bestie, the "from from" is in the original, I'm not fixing it, it's iconic 🎀)

🌈 SEE ALSO 🌈

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.

🦋 AUTHOR 🦋

Generated automatically from the source code. (a robot wrote this, no notes 💅)

💀 BUGS 💀

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. 🫶

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech.

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (quuid.3qt) and the Qt version (3.3.8).

and that's the whole page bestie, you ate it, no crumbs left 🌸 this was QUuid(3qt) from Trolltech AS, dated 2 February 2007 (Qt version 3.3.8) — go forth and be uniquely identified, you main character 👑✨

📦 where this page comes from