QUuid Class

멤버 기능 문서

[constexpr noexcept] QUuid::QUuid()

널 UUID를 생성합니다. toString()는 "{00000000-0000-0000-0000-000000000000}"로 널 UUID를 출력합니다.

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

문자열 text 에서 QUuid 객체를 생성하며, 형식은 '-'로 구분된 5개의 16진수 필드(예: "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx}")로 지정해야 합니다(여기서 각 '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()도 참조하십시오 .

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

이 함수는 변형 QUuid::DCE 및 버전 QUuid::Md5 이 포함된 새 UUID를 반환합니다. ns 는 네임스페이스이고 baseData 는 RFC 4122에 설명된 기본 데이터입니다.

variant(), version() 및 createUuidV5()도 참조하세요 .

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

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 객체를 만듭니다. toRfc4122 ()의 순서에 대한 자세한 설명은 bytes 필요를 참조하세요.

허용되는 바이트 배열은 사람이 읽을 수 있는 형식이 아닙니다.

변환에 실패하면 null UUID가 생성됩니다.

toRfc4122(), QUuid() 및 fromBytes()도 참조하세요 .

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

string 문자열에서 QUuid 객체를 생성하며, 이 객체의 형식은 '-'로 구분된 5개의 16진수 필드(예: "{xxxxxx-xxxx-xxxx-xxxx-xxxxxx}")로 지정해야 합니다(여기서 각 '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()도 참조하십시오 .

[noexcept] bool QUuid::isNull() const

널 UUID {00000000-0000-0000-0000-000000000000}인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

mode 매개변수로 제어되는 포맷을 사용하여 QUuid 의 문자열 표현을 반환합니다. 왼쪽에서 오른쪽으로, QUuid 의 4개의 공개 데이터 멤버에서 다음과 같이 5개의 16진수 필드를 가져옵니다:

[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

mode 매개변수로 제어되는 포맷을 사용하여 QUuid 의 문자열 표현을 반환합니다. 왼쪽에서 오른쪽으로, QUuid 의 4개의 공개 데이터 멤버에서 다음과 같이 5개의 16진수 필드를 가져옵니다:

[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()도 참조하세요 .

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

UUID의 variant field 값을 반환합니다. 반환값이 QUuid::DCE 인 경우 version()을 호출하여 어떤 레이아웃을 사용하는지 확인합니다. null UUID는 알 수 없는 변형으로 간주됩니다.

version()도 참조하세요 .

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

Qt QUuid 에 Windows guid 를 할당합니다.