QUuid类

成员函数文档

[constexpr noexcept] QUuid::QUuid()

创建空UUID。 toString() 将输出null UUID为 "{00000000-0000-0000-0000-000000000000}"。

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

使用参数指定的值创建一个UUID，参数包括l、w1、w2、b1、b2、b3、b4、b5、b6、b7、b8。

示例

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

[explicit noexcept, since 6.6] QUuid::QUuid(QUuid::Id128Bytes id128, QSysInfo::Endian order = QSysInfo::BigEndian)

根据整数参数id128创建一个QUuid对象。输入参数id128被视为具有order字节序。

此功能从Qt 6.6开始引入。

另请参阅 fromBytes()，toBytes()，toRfc4122()和toUInt128。

[explicit noexcept] QUuid::QUuid(QAnyStringView text)

创建一个由字符串text表示的QUuid对象，此字符串必须格式化为由"-"分隔的五个十六进制字段，例如"{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}"，其中每个'x'是十六进制数字。此处显示的花括号是可选的，但通常需要包含它们。如果转换失败，将创建一个空UUID。有关五个十六进制字段如何映射到QUuid公共数据成员的解释，请参阅toString。

另请参阅 toString()和QUuid。

[constexpr noexcept] QUuid::QUuid(const GUID &guid)

将Windows guid转换为Qt QUuid。

[静态] QUuid QUuid::createUuid()

在Windows以外的任何平台上，此函数返回一个新的具有QUuid::DCE变体和QUuid::Random版本的UUID。在Windows上，使用Windows API生成GUID，其类型由API决定创建。

另请参阅 variant()和version。

[static] QUuid QUuid::createUuidV3(const QUuid &ns, const QByteArray &baseData)

此函数返回一个新的UUID，其变体为QUuid::DCE，版本为

另请参阅变体()，版本()，以及 createUuidV5。

[静态] QUuid QUuid::createUuidV3(const QUuid &ns, const QString &baseData)

此函数返回一个新的UUID，其变体为QUuid::DCE，版本为

另请参阅变体()，版本()，以及 createUuidV5。

[静态] QUuid QUuid::createUuidV5(const QUuid &ns, const QByteArray &baseData)

此函数返回一个新的UUID，其变体为QUuid::DCE，版本为

另请参阅变体()，版本()，以及 createUuidV3。

[静态] QUuid QUuid::createUuidV5(const QUuid &ns, const QString &baseData)

此函数返回一个新的UUID，其变体为QUuid::DCE，版本为

另请参阅变体()，版本()，以及 createUuidV3。

[静态，自6.6版起] QUuid QUuid::fromBytes(const void *bytes, QSysInfo::Endian order = QSysInfo::BigEndian)

使用字节顺序 order 从 bytes 中读取128位（16字节）并返回对应这些字节的 QUuid。如果字节顺序 order 为 QSysInfo::BigEndian，则此函数与 fromRfc4122() 所做的一样。

此功能从Qt 6.6开始引入。

另请参阅fromRfc4122。

[静态] QUuid QUuid::fromCFUUID(CFUUIDRef uuid)

构建一个新的 QUuid，其中包含 uuid CFUUID 的副本。

[静态] QUuid QUuid::fromNSUUID(const NSUUID *uuid)

构建一个新的 QUuid，其中包含 uuid NSUUID 的副本。

[静态，noexcept] QUuid QUuid::fromRfc4122(QByteArrayView bytes)

从UUID的二进制表示形式创建 QUuid 对象，该表示形式由RFC 4122第4.1.2节指定。有关 bytes 所需顺序的解释，请参阅 toRfc4122()。

接受的字节数组不是人类可读格式。

如果转换失败，则创建一个空UUID。

另请参阅toRfc4122，QUuid，以及 fromBytes。

[static noexcept] QUuid QUuid::fromString(QAnyStringView string)

从字符串 string 创建一个 QUuid 对象，该字符串必须格式化为由 '-' 分隔的五个十六进制字段，例如："{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}" 其中每个 'x' 都是一个十六进制数字。这里显示的花括号是可选的，但通常包含它们。如果转换失败，则返回空 UUID。请参阅 toString() 了解五个十六进制字段如何映射到 QUuid 中的公共数据成员。

另请参阅 toString()和QUuid。

[static constexpr noexcept, since 6.6] QUuid QUuid::fromUInt128(quint128 uuid, QSysInfo::Endian order = QSysInfo::BigEndian)

基于整数 uuid 参数创建一个 QUuid。输入参数 uuid 被认为是具有 order 字节顺序。

此功能从Qt 6.6开始引入。

另请参阅：toUInt128()，fromBytes()，toBytes() 和 toRfc4122()。

[noexcept] bool QUuid::isNull() const

如果这是空 UUID {00000000-0000-0000-0000-000000000000}，则返回 true；否则返回 false。

QByteArray QUuid::toByteArray(QUuid::StringFormat mode = WithBraces) const

返回此 QUuid 的字符串表示形式，格式由 mode 参数控制。从左到右，五个十六进制字段按以下方式从 QUuid 的四个公共数据成员中获取

[noexcept, since 6.6] QUuid::Id128Bytes QUuid::toBytes(QSysInfo::Endian order = QSysInfo::BigEndian) const

返回一个在由 order 指定的字节顺序中从此 QUuid 创建的 128 位 ID。如果顺序是 QSysInfo::BigEndian，则此函数的二进制内容与 toRfc4122() 相同。请参阅该功能以获取更多详细信息。

此功能从Qt 6.6开始引入。

另请参阅：toRfc4122()，fromBytes() 和 QUuid。

CFUUIDRef QUuid::toCFUUID() const

从 QUuid 创建一个 CFUUID。

调用者拥有 CFUUID，并负责释放它。

NSUUID *QUuid::toNSUUID() const

从 QUuid 创建一个 NSUUID。

NSUUID 会被自动释放。

QByteArray QUuid::toRfc4122() const

返回此 QUuid 的二进制表示形式。字节数组以大端格式存储，并根据RFC 4122第4.1.2节“布局和字节顺序”进行格式化。

顺序如下：

此函数返回的字节数组中的字节包含与toBytes()相同的二进制内容。

另请参阅toBytes()。

QString QUuid::toString(QUuid::StringFormat mode = WithBraces) const

返回此 QUuid 的字符串表示形式，格式由 mode 参数控制。从左到右，五个十六进制字段按以下方式从 QUuid 的四个公共数据成员中获取

[constexpr noexcept, since 6.6] quint128 QUuid::toUInt128(QSysInfo::Endian order = QSysInfo::BigEndian) const

返回从指定的 order 字节序创建的128位整数 QUuid。如果字节序为 QSysInfo::BigEndian，则此函数的二元内容与toRfc4122()相同。有关详细信息，请参阅该函数。

此功能从Qt 6.6开始引入。

另请参阅toRfc4122()，fromUInt128()，toBytes()，fromBytes() 和 QUuid。

[noexcept] QUuid::Variant QUuid::variant() const

返回UUID的variant字段中的值。如果返回值是QUuid::DCE，请调用version()以查看它使用哪种布局。空UUID被视为未知变体。

另请参阅version。

[noexcept] QUuid::Version QUuid::version() const

如果UUID的variant字段是QUuid::DCE，则返回UUID的version字段。否则返回QUuid::VerUnknown。

另请参阅variant。

[constexpr noexcept] GUID QUuid::operator GUID() const

从 QUuid 返回一个Windows GUID。

[constexpr noexcept] bool QUuid::operator!=(const QUuid &other) const

如果此 QUuid 和 other QUuid 不同，则返回 true；否则返回 false。

[constexpr noexcept] bool QUuid::operator!=(const GUID &guid) const

如果此UUID不等于Windows GUID guid，则返回 true；否则返回 false。

[noexcept] bool QUuid::operator<(const QUuid &other) const

如果此 QUuid 具有与 other QUuid 相同的 变体字段 且字典序上小于 other QUuid，则返回 true。如果 other QUuid 具有不同的变体字段，则返回值由比较两个 变体 决定。

另请参阅variant。

[constexpr noexcept] QUuid &QUuid::operator=(const GUID &guid)

将 Windows guid 分配给 Qt QUuid。

[constexpr noexcept] bool QUuid::operator==(const QUuid &other) const

如果此 QUuid 和 other QUuid 相同，则返回 true；否则返回 false。

[constexpr noexcept] bool QUuid::operator==(const GUID &guid) const

如果此 UUID 等于 Windows GUID guid，则返回 true；否则返回 false。

[noexcept] bool QUuid::operator>(const QUuid &other) const

如果此 QUuid 具有与 other QUuid 相同的 变体字段 且字典序上大于 other QUuid，则返回 true。如果 other QUuid 具有不同的变体字段，则返回值由比较两个 变体 决定。

另请参阅variant。