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 이외의 모든 플랫폼에서 이 함수는 변형(variant)이 QUuid::DCE 이고 버전이 QUuid::Random 인 새로운 UUID를 반환합니다. Windows에서는 Windows API를 사용하여 GUID가 생성되며, 이 GUID는 API가 생성하기로 결정한 유형이 됩니다.

variant() 및 version()도 참조하십시오 .

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

이 함수는 변형(variant) QUuid::DCE 및 버전(version) QUuid::Md5 을 가진 새로운 UUID를 반환합니다. ns 는 네임스페이스이며, baseData 는 RFC 4122에 명시된 기본 데이터입니다.

variant(), version(), createUuidV5(), createUuidV7()도 참조하십시오 .

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

이 함수는 변형(variant) QUuid::DCE 및 버전(version) QUuid::Md5 을 가진 새로운 UUID를 반환합니다. ns 는 네임스페이스이며, baseData 는 RFC 4122에 설명된 기본 데이터입니다.

variant(), version(), createUuidV5() 및 createUuidV7()도 참조하십시오 .

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

이 함수는 변형(variant) QUuid::DCE 및 버전(version) QUuid::Sha1 을 가진 새로운 UUID를 반환합니다. ns 는 네임스페이스이며, baseData 는 RFC 4122에 명시된 기본 데이터입니다.

variant(), version(), createUuidV3()도 참조하십시오 .

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

이 함수는 변형(variant) QUuid::DCE 및 버전(version) QUuid::Sha1 을 가진 새로운 UUID를 반환합니다. ns 는 네임스페이스이며, baseData 는 RFC 4122에 설명된 기본 데이터입니다.

variant(), version(), createUuidV3()도 참조하십시오 .

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

이 함수는 변형( QUuid::DCE )과 버전( QUuid::UnixEpoch)을 가진 새로운 UUID를 반환합니다.

이 함수는 RFC 9562에 명시된 대로 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}인 null UUID인 경우 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 ` 매개변수에 의해 제어됩니다. 왼쪽에서 오른쪽으로, 다섯 개의 16진수 필드는 ` 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()`를 호출하여 어떤 레이아웃을 사용하는지 확인하십시오. 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 QUuid 에 할당합니다.