QUuid Class

成员函数文档

[constexpr noexcept] QUuid::QUuid()

生成空 UUID。toString() 将输出该空 UUID，格式为“{00000000-0000-0000-0000-000000000000}”。

[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。

[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()。

[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);

[static] QUuid QUuid::createUuid()

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

另请参阅 variant() 和version()。

[static noexcept] QUuid QUuid::createUuidV3(QUuid ns, QByteArrayView baseData)

该函数返回一个新的 UUID，其变体为QUuid::DCE ，版本为QUuid::Md5 。ns 是命名空间，baseData 是 RFC 4122 中描述的基本数据。

另请参阅 variant()、version()、createUuidV5() 和createUuidV7()。

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

该函数返回一个新的 UUID，其变体为QUuid::DCE ，版本为QUuid::Md5 。ns 是命名空间，baseData 是 RFC 4122 中描述的基本数据。

另请参阅 variant()、version()、createUuidV5() 以及createUuidV7()。

[static noexcept] QUuid QUuid::createUuidV5(QUuid ns, QByteArrayView baseData)

该函数返回一个新的 UUID，其变体为QUuid::DCE ，版本为QUuid::Sha1 。ns 是命名空间，baseData 是 RFC 4122 中描述的基本数据。

另请参阅 variant()、version() 和createUuidV3()。

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

该函数返回一个新的 UUID，其变体为QUuid::DCE ，版本为QUuid::Sha1 。ns 是命名空间，baseData 是 RFC 4122 中描述的基本数据。

另请参阅 variant()、version() 和createUuidV3()。

[static, since 6.9] QUuid QUuid::createUuidV7()

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

它使用一个按时间排序的值字段，该字段源自自 UNIX 纪元以来的毫秒数，具体如RFC9562 所述。

该函数在 Qt 6.9 中引入。

另请参阅 variant()、version()、createUuidV3() 和createUuidV5()。

[static, since 6.6] QUuid QUuid::fromBytes(const void *bytes, QSysInfo::Endian order = QSysInfo::BigEndian)

从bytes 中读取128位（16字节）数据，采用字节顺序order ，并返回与这些字节对应的QUuid 。如果字节顺序order 为QSysInfo::BigEndian ，则该函数的功能与fromRfc4122()相同。

该函数在 Qt 6.6 中引入。

另请参阅 fromRfc4122()。

[static] QUuid QUuid::fromCFUUID(CFUUIDRef uuid)

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

[static] QUuid QUuid::fromNSUUID(const NSUUID *uuid)

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

[static noexcept] QUuid QUuid::fromRfc4122(QByteArrayView bytes)

根据 RFC 4122 第 4.1.2 节的规定，从 UUID 的二进制表示形式创建一个 `QUuid ` 对象。有关所需 `bytes ` 的顺序的进一步说明，请参阅toRfc4122()。

接受的字节数组并非人类可读格式。

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

另请参阅 toRfc4122()、QUuid() 和fromBytes()。

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

根据字符串string 创建一个QUuid 对象，该字符串必须以五个用 '-' 分隔的十六进制字段格式表示，例如 "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}"，其中每个 'x' 代表一个十六进制数字。 此处显示的大括号是可选的，但通常会包含它们。如果转换失败，则返回一个空 UUID。有关这五个十六进制字段如何映射到QUuid 中的公共数据成员的说明，请参见toString()。

另请参阅 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()。

[constexpr 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

返回一个基于此QUuid 并按order 指定的字节顺序生成的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

返回一个由该QUuid 根据order 指定的字节序生成的128位整数。如果字节序为QSysInfo::BigEndian ，则该函数的二进制内容与toRfc4122()相同。更多详细信息请参阅该函数。

该函数于 Qt 6.6 中引入。

另请参阅 toRfc4122()、fromUInt128()、toBytes()、fromBytes() 以及QUuid()。

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

返回该UUID在variant field 中的值。如果返回值为QUuid::DCE ，请调用version()以查看其使用的布局。空UUID被视为未知变体。

另请参阅 version()。

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

如果该 UUID 的variant field 为QUuid::DCE ，则返回该 UUID 的version field 。否则，返回QUuid::VerUnknown 。

另请参阅 variant()。

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

根据QUuid 返回一个Windows GUID。

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

将一个 Windowsguid 分配给一个 QtQUuid 。