Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QUuid Class Reference
^{[модуль QtCore ]}

The QUuid class stores a Universally Unique Identifier (UUID). Далее...

 #include <QUuid>

Примечание: все функции в этом классе реентерабельны.

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

[править] Открытые типы

• enum Variant { VarUnknown, NCS, DCE, Microsoft, Reserved }
• enum Version { VerUnknown, Time, EmbeddedPOSIX, Name, Random }

[править] Открытые функции

• QUuid ()
• QUuid ( uint l, ushort w1, ushort w2, uchar b1, uchar b2, uchar b3, uchar b4, uchar b5, uchar b6, uchar b7, uchar b8 )
• QUuid ( const QString & text )
• QUuid ( const GUID & guid )
• bool isNull () const
• QString toString () const
• QUuid::Variant variant () const
• QUuid::Version version () const
• operator GUID () const
• operator QString () const
• bool operator!= ( const QUuid & other ) const
• bool operator!= ( const GUID & guid ) const
• bool operator< ( const QUuid & other ) const
• QUuid & operator= ( const GUID & guid )
• bool operator== ( const QUuid & other ) const
• bool operator== ( const GUID & guid ) const
• bool operator> ( const QUuid & other ) const

[править] Статические открытые члены

• QUuid createUuid ()

[править] Связанные не-члены

• QDataStream & operator<< ( QDataStream & s, const QUuid & id )
• QDataStream & operator>> ( QDataStream & s, QUuid & id )

[править] Подробное описание

The QUuid class stores a Universally Unique Identifier (UUID).

For objects or declarations that must be uniquely identified, UUIDs (also known as GUIDs) are widely used in order to assign a fixed and easy to compare value to the object or declaration. The 128-bit value of a UUID is generated by an algorithm that guarantees that the value is unique.

In Qt, UUIDs are wrapped by the QUuid struct which provides convenience functions for handling UUIDs. Most platforms provide a tool to generate new UUIDs, for example, uuidgen and guidgen.

UUIDs generated by QUuid, are based on the Random version of the DCE (Distributed Computing Environment) standard.

UUIDs can be constructed from numeric values or from strings, or using the static createUuid() function. They can be converted to a string with toString(). UUIDs have a variant() and a version(), and null UUIDs return true from isNull().

[править] Описание типов

[править]

enum QUuid::Variant

This enum defines the variant of the UUID, which is the scheme which defines the layout of the 128-bits value.

[править]

enum QUuid::Version

This enum defines the version of the UUID.

[править] Описание функций-членов

[править]

QUuid::QUuid ()

Creates the null UUID {00000000-0000-0000-0000-000000000000}.

[править]

QUuid::QUuid ( uint l, ushort w1, ushort w2, uchar b1, uchar b2, uchar b3, uchar b4, uchar b5, uchar b6, uchar b7, uchar b8 )

Creates a UUID with the value specified by the parameters, 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 ( const QString & text )

Creates a QUuid object from the string text. The function can only convert a string in the format {HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} (where 'H' stands for a hex digit). If the conversion fails a null UUID is created.

[править]

QUuid::QUuid ( const GUID & guid )

Casts a Windows guid to a Qt QUuid.

Warning: This function is only for Windows platforms.

[править]

QUuid QUuid::createUuid () [static]

Returns a new UUID of DCE variant, and Random type. The UUIDs generated are based on the platform specific pseudo-random generator, which is usually not a cryptographic-quality random number generator. Therefore, a UUID is not guaranteed to be unique cross application instances.

On Windows, the new UUID is extremely likely to be unique on the same or any other system, networked or not.

See also variant() and version().

[править]

bool QUuid::isNull () const

Returns true if this is the null UUID {00000000-0000-0000-0000-000000000000}; otherwise returns false.

[править]

QString QUuid::toString () const

Returns the string representation of the uuid.

[править]

QUuid::Variant QUuid::variant () const

Returns the variant of the UUID. The null UUID is considered to be of an unknown variant.

See also version().

[править]

QUuid::Version QUuid::version () const

Returns the version of the UUID, if the UUID is of the DCE variant; otherwise returns VerUnknown.

See also variant().

[править]

QUuid::operator GUID () const

Returns a Windows GUID from a QUuid.

Warning: This function is only for Windows platforms.

[править]

QUuid::operator QString () const

Returns the string representation of the uuid.

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

[править]

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

Returns true if this QUuid and the other QUuid are different; otherwise returns false.

[править]

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

Эта перегруженная функция предоставлена для удобства.

Returns true if this UUID is not equal to the Windows GUID guid; otherwise returns false.

[править]

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

Returns true if this QUuid is of the same variant, and lexicographically before the other QUuid; otherwise returns false.

See also variant().

[править]

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

Assigns a Windows guid to a Qt QUuid.

Warning: This function is only for Windows platforms.

[править]

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

Returns true if this QUuid and the other QUuid are identical; otherwise returns false.

[править]

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

Эта перегруженная функция предоставлена для удобства.

Returns true if this UUID is equal to the Windows GUID guid; otherwise returns false.

[править]

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

Returns true if this QUuid is of the same variant, and lexicographically after the other QUuid; otherwise returns false.

See also variant().

[править] Связанные не-члены

[править]

QDataStream & operator<< ( QDataStream & s, const QUuid & id )

Эта перегруженная функция предоставлена для удобства.

Writes the uuid id to the datastream s.

[править]

QDataStream & operator>> ( QDataStream & s, QUuid & id )

Эта перегруженная функция предоставлена для удобства.

Reads uuid from from the stream s into id.