QUuid Class

成员函数文档

[constexpr noexcept] QUuid::QUuid()

创建空 UUID。toString() 将把空 UUID 输出为"{000000-0000-0000-0000-0000000000}"。

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

从字符串text 中创建一个 QUuid 对象，该字符串必须格式化为以"-"分隔的五个十六进制字段，例如"{xxxxxxxxx-xxxxxxx-xxxxxxx-xxxxxxxxxxx}"，其中每个 "x "都是一个十六进制数字。这里显示的大括号是可选的，但一般都会包括在内。如果转换失败，将创建一个空 UUID。有关五个十六进制字段如何映射到 QUuid 中公共数据成员的解释，请参见toString()。

另请参阅 toString() 和QUuid()。

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

将 Windowsguid 转换为 Qt XML 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 平台上，GUID 是使用 Windows API 生成的，其类型由 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 。

它使用了一个按时间排序的值域，该值域由RFC9562 所描述的自 UNIX Epoch 开始的毫秒数衍生而来。

该函数在 Qt 6.9 中引入。

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

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

[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 对象，该字符串必须格式化为以"-"分隔的五个十六进制字段，例如"{xxxxxxxxx-xxxxxxx-xxxxxxx-xxxxxxxxxxx}"，其中每个 "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

返回根据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 的二进制表示。字节数组采用 big endian 格式，格式符合 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 指定的字节顺序从QUuid 创建的 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] GUID QUuid::operator GUID() const

从QUuid 返回 Windows GUID。

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

将 Windowsguid 分配给 QtQUuid 。