QUuid Class

メンバー関数のドキュメント

[constexpr noexcept] QUuid::QUuid()

null UUID を作成します。toString() は、null UUID を「{00000000-0000-0000-0000-000000000000}」として出力します。

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

文字列 `text` から QUuid オブジェクトを作成します。この文字列は、「-」で区切られた 5 つの 16 進数フィールドで構成されている必要があります。例えば、`"{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}"` のように、各「x」は 16 進数の数字を表します。 ここに示されている中括弧は省略可能ですが、通常は含めるのが一般的です。変換に失敗した場合、null UUID が作成されます。5 つの 16 進フィールドが 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)

パラメータで指定された値（l 、w1 、w2 、b1 、b2 、b3 、b4 、b5 、b6 、b7 、b8 ）を用いてUUIDを生成します。

例：

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

[static] QUuid QUuid::createUuid()

Windows 以外のプラットフォームでは、この関数はバリアントQUuid::DCE 、バージョンQUuid::Random の新しい UUID を返します。Windows では、Windows API を使用して GUID が生成され、その型は API が決定した型になります。

variant() およびversion()も参照してください 。

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

この関数は、バリアントQUuid::DCE 、バージョンQUuid::Md5 の新しい UUID を返します。ns は名前空間、baseData は RFC 4122 で規定されている基本データです。

関連項目： variant()、version()、createUuidV5()、およびcreateUuidV7()。

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

この関数は、バリアントがQUuid::DCE 、バージョンがQUuid::Md5 の新しいUUIDを返します。ns は名前空間であり、baseData はRFC 4122で規定されている基本データです。

variant()、version()、createUuidV5()、およびcreateUuidV7()も参照してください 。

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

この関数は、バリアントがQUuid::DCE 、バージョンがQUuid::Sha1 である新しいUUIDを返します。ns は名前空間、baseData はRFC 4122で規定されている基本データです。

variant()、version()、およびcreateUuidV3()も参照してください 。

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

この関数は、バリアントQUuid::DCE およびバージョンQUuid::Sha1 を持つ新しい UUID を返します。ns は名前空間であり、baseData は RFC 4122 で規定されている基本データです。

variant()、version()、およびcreateUuidV3()も参照してください 。

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

この関数は、バリアントQUuid::DCE 、バージョンQUuid::UnixEpoch を持つ新しいUUIDを返します。

この関数は、RFC9562で規定されているように、UNIXエポックからの経過ミリ秒数から導出された、時間順の値フィールドを使用します。

この関数は Qt 6.9 で導入されました。

variant()、version()、createUuidV3()、およびcreateUuidV5()も参照してください 。

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

bytes から、バイト順order を使用して128ビット（16バイト）を読み取り、それらのバイトに対応するQUuid を返します。バイト順order がQSysInfo::BigEndian の場合、この関数はfromRfc4122()と同じ動作をします。

この関数は Qt 6.6 で導入されました。

fromRfc4122()も参照してください 。

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

uuid のCFUUIDのコピーを含む、新しいQUuid を生成します。

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

uuid のNSUUIDのコピーを含む、新しいQUuid を生成します。

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

RFC 4122のセクション4.1.2で規定されているように、UUIDのバイナリ表現からQUuid オブジェクトを作成します。必要なbytes の順序に関する詳細については、toRfc4122()を参照してください。

受け付けるバイト配列は、人間が読み取れる形式ではありません。

変換に失敗した場合、null UUID が作成されます。

toRfc4122()、QUuid()、およびfromBytes()も参照してください 。

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

文字列 `string` から `QUuid ` オブジェクトを作成します。この文字列は、「-」で区切られた 5 つの 16 進数フィールドで構成されている必要があります。例：`"{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}"`。各「x」は 16 進数の桁を表します。 ここに示されている中括弧は省略可能ですが、通常は含めるのが一般的です。変換に失敗した場合は、nullのUUIDが返されます。5つの16進数フィールドが、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 パラメータによって制御されます。左から右へと、5つの16進数フィールドは、QUuid 内の4つのパブリックデータメンバーから次のように取得されます：

[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 パラメータによって制御されます。左から右へと、5つの16進数フィールドは、QUuid 内の4つのパブリックデータメンバーから次のように取得されます：

[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()を呼び出して、どのレイアウトが使用されているかを確認してください。nullの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)

Windowsのguid をQt XMLのQUuid に割り当てます。