Класс QUuid

Класс QUuid хранит универсальный идентификатор (UUID). Подробнее...

• Список всех членов, включая наследуемые

Примечание: Все функции в этом классе являются взаимоблокирующимися.

Типы

Открытые функции

Статические публичные члены

Связанные нечлены

Подробное описание

Использование универсальных уникальных идентификаторов (UUID) — это стандартный способ уникальной идентификации сущностей в распределенной вычислительной среде. UUID — это 16-байтовое (128-битное) число, генерируемое каким-либо алгоритмом, который призван гарантировать, что UUID будет уникальным в распределённой вычислительной среде, где он используется. Иногда используется аббревиатура GUID вместо неё, Глобальные уникальные идентификаторы, но это относится к одному и тому же.

На самом деле, GUID — один из вариантов UUID. Используются несколько вариантов. Каждый UUID содержит битовое поле, указывающее тип (вариант) UUID. Вызовите variant(), чтобы определить, какой тип UUID содержит экземпляр QUuid. Он извлекает три старших бита байта 8 из 16 байтов. В QUuid байт 8 — QUuid::data4[0]. Если вы создаёте экземпляры QUuid, используя конструктор, принимающий все числовые значения в качестве параметров, используйте следующую таблицу для установки трёх старших битов параметра b1, который становится QUuid::data4[0] и содержит поле варианта в своих трёх старших битах. В таблице «x» означает «неважно».

Если variant() возвращает QUuid::DCE, UUID также содержит поле версии в четырёх старших битах QUuid::data3, и вы можете вызвать version(), чтобы определить, какую версию содержит ваш QUuid. Если вы создаёте экземпляры QUuid, используя конструктор, принимающий все числовые значения в качестве параметров, используйте следующую таблицу для установки четырёх старших битов параметра w2, который становится QUuid::data3 и содержит поле версии в своих четырёх старших битах.

Макеты полей для версий DCE, перечисленных в таблице выше, определены в Спецификации UUID рабочей группы сети.

Большинство платформ предоставляют инструмент для генерации новых UUID, например, uuidgen и guidgen. Вы также можете использовать createUuid(). UUID, сгенерированные с помощью createUuid(), имеют случайный тип. Их биты QUuid::Version установлены в QUuid::Случайный, а биты QUuid::Variant — в QUuid::DCE. Остальная часть UUID состоит из случайных чисел. Теоретически это означает, что существует небольшая вероятность того, что UUID, сгенерированный с помощью createUuid(), не будет уникальным. Но это очень малая вероятность.

UUID можно создать из числовых значений или строк, или используя статическую функцию createUuid(). Их можно преобразовать в строку с помощью toString(). UUID имеют variant() и version(), и нулевые UUID возвращают true от isNull().

Документация по типу члена

enum QUuid::StringFormat

Этот перечисление используется toString(StringFormat) для управления форматированием строкового представления. Возможные значения:

Это перечисление было введено или изменено в Qt 5.11.

enum QUuid::Variant

Это перечисление определяет значения, используемые в поле variant UUID. Значение в поле variant определяет макет 128-битового значения.

enum QUuid::Version

Это перечисление определяет значения, используемые в поле версии UUID. Поле версии имеет значение только если значение в поле variant равно QUuid::DCE.

Документация по функциям членов

QUuid::QUuid(const GUID &guid)

Преобразует Windows guid в Qt QUuid.

Предупреждение: Эта функция предназначена только для платформ Windows.

QUuid::QUuid(const QByteArray &text)

Создаёт объект QUuid из QByteArray text, который должен быть отформатирован как пять шестнадцатеричных полей, разделённых '-', например, "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}", где каждая 'x' — шестнадцатеричная цифра. Фигурные скобки, показанные здесь, необязательны, но их обычно включают. Если преобразование завершается неудачно, создаётся нулевой UUID. См. toByteArray() для объяснения того, как пять шестнадцатеричных полей сопоставляются с общедоступными членами данных в QUuid.

Эта функция была введена в Qt 4.8.

См. также toByteArray() и QUuid().

QUuid::QUuid(const QString &text)

Создаёт объект QUuid из строки text, которая должна быть отформатирована как пять шестнадцатеричных полей, разделённых '-', например, "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}", где каждая 'x' — шестнадцатеричная цифра. Фигурные скобки, показанные здесь, необязательны, но их обычно включают. Если преобразование завершается неудачно, создаётся нулевой UUID. См. toString() для объяснения того, как пять шестнадцатеричных полей сопоставляются с общедоступными членами данных в QUuid.

См. также toString() и QUuid().

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

QUuid::QUuid()

Создаёт нулевой UUID. toString() отобразит нулевой UUID как "{00000000-0000-0000-0000-000000000000}".

QUuid &QUuid::operator=(const GUID &guid)

Присваивает Windows guid объекту Qt QUuid.

Предупреждение: Эта функция предназначена только для платформ Windows.

[static] QUuid QUuid::createUuid()

На платформах, отличных от Windows, эта функция возвращает новый UUID с вариантом QUuid::DCE и версией QUuid::Случайный. На Windows генерируется GUID с использованием API Windows и будет иметь тип, который API решает создать.

См. также variant() и version().

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

Эта функция возвращает новый UUID с вариантом QUuid::DCE и версией QUuid::Md5. ns — это пространство имён, а baseData — базовые данные, как описано в RFC 4122.

Эта функция была введена в Qt 5.0.

См. также variant(), version() и createUuidV5().

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

Эта функция возвращает новый UUID с вариантом QUuid::DCE и версией QUuid::Md5. ns — это имя пространства, а baseData — основные данные, как описано в RFC 4122.

Эта функция была добавлена в Qt 5.0.

См. также variant(), version() и createUuidV5().

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

Эта функция возвращает новый UUID с вариантом QUuid::DCE и версией QUuid::Sha1. ns — это имя пространства, а baseData — основные данные, как описано в RFC 4122.

Эта функция была добавлена в Qt 5.0.

См. также variant(), version() и createUuidV3().

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

Эта функция возвращает новый UUID с вариантом QUuid::DCE и версией QUuid::Sha1. ns — это имя пространства, а baseData — основные данные, как описано в RFC 4122.

Эта функция была добавлена в Qt 5.0.

См. также variant(), version() и createUuidV3().

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

Создаёт новый QUuid, содержащий копию CFUUID uuid.

Примечание: эта функция доступна только на платформах Apple.

Эта функция была добавлена в Qt 5.7.

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

Создаёт новый QUuid, содержащий копию NSUUID uuid.

Примечание: эта функция доступна только на платформах Apple.

Эта функция была добавлена в Qt 5.7.

[static] QUuid QUuid::fromRfc4122(const QByteArray &bytes)

Создаёт объект QUuid из двоичного представления UUID, как указано в RFC 4122 раздел 4.1.2. См. toRfc4122() для дополнительного объяснения порядка байтов bytes.

Принимаемый массив байтов НЕ является удобочитаемым форматом.

Если преобразование завершилось неудачно, создаётся нулевой UUID.

Эта функция была добавлена в Qt 4.8.

См. также toRfc4122() и QUuid().

[static] QUuid QUuid::fromString(QStringView text)

Создаёт объект QUuid из строки text, которая должна быть отформатирована как пять шестнадцатеричных полей, разделенных дефисами, например, "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}", где каждая 'x' — шестнадцатеричная цифра. Фигурные скобки здесь необязательны, но их обычно включают. Если преобразование завершилось неудачно, возвращается нулевой UUID. См. toString() для объяснения того, как пять шестнадцатеричных полей сопоставляются с общедоступными данными в QUuid.

Эта функция была добавлена в Qt 5.10.

См. также toString() и QUuid().

[static] QUuid QUuid::fromString(QLatin1String text)

Это перегруженная функция.

Создаёт объект QUuid из строки text, которая должна быть отформатирована как пять шестнадцатеричных полей, разделенных дефисами, например, "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}", где каждая 'x' — шестнадцатеричная цифра. Фигурные скобки здесь необязательны, но их обычно включают. Если преобразование завершилось неудачно, возвращается нулевой UUID. См. toString() для объяснения того, как пять шестнадцатеричных полей сопоставляются с общедоступными данными в QUuid.

Эта функция была добавлена в Qt 5.10.

См. также toString() и QUuid().

bool QUuid::isNull() const

Возвращает true если это нулевой UUID {00000000-0000-0000-0000-000000000000}; в противном случае возвращает false.

QByteArray QUuid::toByteArray() const

Возвращает двоичное представление этого QUuid. Массив байтов отформатирован как пять шестнадцатеричных полей, разделённых дефисами и заключённых в фигурные скобки, т.е. "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}", где 'x' — шестнадцатеричная цифра. Слева направо пять шестнадцатеричных полей получены из четырёх общедоступных данных в QUuid следующим образом:

Эта функция была добавлена в Qt 4.8.

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

Возвращает строковое представление этого QUuid с форматированием, управляемым параметром mode. Слева направо пять шестнадцатеричных полей получены из четырёх общедоступных данных в QUuid следующим образом:

Эта функция была добавлена в Qt 5.11.

CFUUIDRef QUuid::toCFUUID() const

Создаёт CFUUID из QUuid. Вызывающий владелец CFUUID и отвечает за его освобождение.

Примечание: эта функция доступна только на платформах Apple.

Эта функция была добавлена в Qt 5.7.

NSUUID *QUuid::toNSUUID() const

Создаёт NSUUID из QUuid. NSUUID автоматически освобождается.

Примечание: эта функция доступна только на платформах Apple.

Эта функция была добавлена в Qt 5.7.

QByteArray QUuid::toRfc4122() const

Возвращает двоичное представление этого QUuid. Массив байтов в формате big endian и отформатирован в соответствии с RFC 4122, раздел 4.1.2 — «Макет и порядок байтов».

Порядок следующий:

Эта функция была добавлена в Qt 4.8.

QString QUuid::toString() const

Возвращает строковое представление этого QUuid. Строка отформатирована как пять шестнадцатеричных полей, разделённых дефисами и заключённых в фигурные скобки, т.е. "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}", где 'x' — шестнадцатеричная цифра. Слева направо пять шестнадцатеричных полей получены из четырёх общедоступных данных в QUuid следующим образом:

QString QUuid::toString(QUuid::StringFormat mode) const

Возвращает строковое представление этого QUuid с форматированием, управляемым параметром mode. Слева направо пять шестнадцатеричных полей получены из четырёх общедоступных данных в QUuid следующим образом:

Эта функция была добавлена в Qt 5.11.

QUuid::Variant QUuid::variant() const

Возвращает значение в поле варианта UUID. Если возвращаемое значение QUuid::DCE, вызовите version(), чтобы увидеть используемый макет. Нулевой UUID считается с неизвестным вариантом.

См. также version().

QUuid::Version QUuid::version() const

Возвращает поле версии UUID, если поле варианта UUID равно QUuid::DCE. В противном случае возвращает QUuid::VerUnknown.

См. также variant().

GUID QUuid::operator GUID() const

Возвращает GUID Windows из QUuid.

Предупреждение: Эта функция предназначена только для платформ Windows.

bool QUuid::operator!=(const QUuid &other) const

Возвращает true если этот QUuid и QUuid other отличаются; в противном случае возвращает false.

bool QUuid::operator!=(const GUID &guid) const

Возвращает true если этот UUID не равен Windows GUID guid; в противном случае возвращает false.

bool QUuid::operator<(const QUuid &other) const

Возвращает true если у этого QUuid такой же поле варианта, как у QUuid other, и он лексикографически предшествует QUuid other. Если у QUuid other другое поле варианта, возвращаемое значение определяется путём сравнения двух вариантов.

См. также variant().

bool QUuid::operator==(const QUuid &other) const

Возвращает true если этот QUuid и QUuid other идентичны; в противном случае возвращает false.

bool QUuid::operator==(const GUID &guid) const

Возвращает true если этот UUID равен Windows GUID guid; в противном случае возвращает false.

bool QUuid::operator>(const QUuid &other) const

Возвращает true если у этого QUuid такое же поле варианта, как у QUuid other, и он лексикографически следует за QUuid other. Если у QUuid other другое поле варианта, возвращаемое значение определяется путём сравнения двух вариантов.

См. также variant().