Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QUuid Class Reference
[QtCore module]

该QUuid类存储通用唯一标识符(UUID) 。More...

Types

Methods

Static Methods

Special Methods


Detailed Description

该QUuid类存储通用唯一标识符(UUID) 。

Using UniversallyUNIQUEIDentifiers ( UUID)是一种标准的方式来唯一地标识在分布式计算环境中的实体。 UUID是一个由一些算法,是为了保证该UUID将是唯一的在那里它被用来在分布式计算环境中产生的16字节(128位)的数目。首字母缩写词的GUID通常用来代替,GloballyUNIQUEIDentifiers ,但它指的是同一件事。

实际上,该GUID是1variant的UUID。多个变体都在使用。每个UUID包含一个位域,指定它是UUID的类型(变种) 。通话variant()来发现哪些类型的UUID QUuid的实例包含的内容。它提取的16个字节的字节8的三个最signifcant比特。在QUuid ,字节是8QUuid.data4[0]。如果您使用接受所有的数值作为参数的构造函数中创建QUuid的实例,请使用下表来设置参数的三个最显着的位b1,成为QUuid.data4[0]并包含在它的三个最显着位变体领域。在该表中, “ X”表示don't care

msb0 msb1 msb2 Variant
0 x x NCS (Network Computing System)
1 0 x DCE (Distributed Computing Environment)
1 1 0 Microsoft (GUID)
1 1 1 Reserved for future expansion

If variant()返回QUuid.DCE,的UUID还包含一个version中的四个最显着的位场QUuid.data3,你可以调用version( )来发现哪个版本的QUuid包含。如果您使用接受所有的数值作为参数的构造函数中创建QUuid的实例,请使用下表来设置参数的四个最显着的位w2,成为QUuid.data3并包含在其四个最显着位版本字段。

msb0 msb1 msb2 msb3 Version
0 0 0 1 Time
0 0 1 0 Embedded POSIX
0 0 1 1 Name
0 1 0 0 Random

现场布局在表中列出的DCE版本在指定的Network Working Group UUID Specification

大多数平台上生成新的UUID ,例如提供一个工具uuidgenguidgen。您也可以使用createUuid( ) 。所产生的UUIDcreateUuid()是随机型。他们的QUuid.Version位被设置为QUuid.Random,和它们的QUuid.Variant位被设置为QUuid.DCE。的UUID的其馀部分是由随机数。从理论上讲,这意味着有一个UUID,通过产生一个小的机会createUuid( )将不会是唯一的。但它是 a very small chance

的UUID可以由数值或字符串的构造,或使用静态createUuid()函数。它们可以被转换成一个字符串toString( ) 。 UUID的有variant()和一个version( ) ,和空的UUID返回True从isNull( ) 。


Type Documentation

QUuid.Variant

这个枚举变量定义在使用的值variant field的UUID 。在变型字段中的值决定了128位值的布局。

Constant Value Description
QUuid.VarUnknown -1 Variant是未知
QUuid.NCS 0 预留NCS (网络计算系统)的向后兼容性
QUuid.DCE 2 分布式计算环境,使用计划QUuid
QUuid.Microsoft 6 保留给微软向后兼容( GUID )
QUuid.Reserved 7 保留为将来之定义

QUuid.Version

这个枚举变量定义在使用的值version field的UUID 。版本字段是有意义的,只有在价值variant field is QUuid.DCE

Constant Value Description
QUuid.VerUnknown -1 版本未知
QUuid.Time 1 以时间为基础,通过使用时间戳,时钟序列,和MAC网卡地址(如果有)为节点部分
QUuid.EmbeddedPOSIX 2 DCE安全的版本,带有嵌入式POSIX的UUID
QUuid.Name 3 基于名称的,使用的值从一个名进行的所有部分
QUuid.Random 4 随机化,通过使用随机数的所有节

Method Documentation

QUuid.__init__ (self)

创建空的UUID 。toString( )将输出空UUID作为“ { 00000000-0000-0000-0000-000000000000 } ” 。

QUuid.__init__ (self, int l, int w1, int w2, str b1, str b2, str b3, str b4, str b5, str b6, str b7, str b8)

创建一个具有由参数指定的值一个UUID ,lw1w2b1b2b3b4b5b6b7b8

例如:

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

QUuid.__init__ (self, QString)

创建QUuid从字符串对象text,它必须格式化为相隔5进制领域“ - ” ,如“ { XXXXXXXX - XXXX-XXXX- XXXX-XXXXXXXXXXXX } ”,其中“X”是一个十六进制数字。这里显示的花括号是可选的,但它是正常的,包括他们。如果转换失败,空UUID被创建。看toString( )对于如何五十六进制字段映射到公共数据成员的解释QUuid

See also toString()和QUuid( ) 。

QUuid.__init__ (self, QByteArray)

QUuid.__init__ (self, QUuid)

创建QUuid从对象QByteArray text,它必须格式化为相隔5进制领域“ - ” ,如“ { XXXXXXXX - XXXX-XXXX- XXXX-XXXXXXXXXXXX } ”,其中“X”是一个十六进制数字。这里显示的花括号是可选的,但它是正常的,包括他们。如果转换失败,空UUID被创建。看toByteArray( )对于如何五十六进制字段映射到公共数据成员的解释QUuid

此功能被引入Qt的4.8 。

See also toByteArray()和QUuid( ) 。

QUuid QUuid.createUuid ()

在Windows以外的任何平台上,这个函数返回一个新的UUID与变异QUuid.DCE和版本QUuid.Random。如果在/ dev / urandom设备存在,则用于构造UUID的号码将加密的质量,这将使得UUID是唯一的。否则,该UUID的号码将被从本地伪随机数发生器(得到qrand( ),它是由接种qsrand()) ,这是cryptograhic质量通常不是,表示的UUID不能保证是唯一的。

在Windows平台上,一个GUID生成,这几乎肯定will是唯一的,在这个或任何其他系统,联网与否。

See also variant()和version( ) 。

QUuid QUuid.fromRfc4122 (QByteArray)

创建QUuid从给定的UUID的二进制表示反对bytes,指定由RFC 4122第4.1.2节。看toRfc4122( )为所需的字节顺序的进一步解释。

接受字节数组not一个人类可读的格式。

如果转换失败,空UUID被创建。

此功能被引入Qt的4.8 。

See also toRfc4122()和QUuid( ) 。

bool QUuid.isNull (self)

返回True如果是空的UUID { 00000000-0000-0000-0000-000000000000 } ,否则返回False 。

QByteArray QUuid.toByteArray (self)

返回此二进制表示QUuid。字节数组的格式为分离五十六场“ - ”和大括号括起来,即“ { XXXXXXXX - XXXX-XXXX- XXXX-XXXXXXXXXXXX } ”,其中“X”是一个十六进制数字。由左到右,五十六进制字段从在四个公共数据成员获得QUuid如下:

Field # Source
1 data1
2 data2
3 data3
4 data4[0] .. data4[1]
5 data4[2] .. data4[7]

此功能被引入Qt的4.8 。

QByteArray QUuid.toRfc4122 (self)

返回此二进制表示QUuid。字节数组是用big endian格式,并根据RFC 4122 ,第4.1.2格式化 - “布局和字节顺序” 。

的顺序如下所示:

Field # Source
1 data1
2 data2
3 data3
4 data4[0] .. data4[7]

此功能被引入Qt的4.8 。

QString QUuid.toString (self)

返回此字符串表示形式QUuid。该字符串的格式为分离五十六场“ - ”和大括号括起来,即“ { XXXXXXXX - XXXX-XXXX- XXXX-XXXXXXXXXXXX } ”,其中“X”是一个十六进制数字。由左到右,五十六进制字段从在四个公共数据成员获得QUuid如下:

Field # Source
1 data1
2 data2
3 data3
4 data4[0] .. data4[1]
5 data4[2] .. data4[7]

Variant QUuid.variant (self)

传回值variant field的UUID 。如果返回值是QUuid.DCE,调用version() ,看看哪些布局它使用。空的UUID被认为是一个未知的变体。

See also version( ) 。

Version QUuid.version (self)

返回version field的UUID的,如果UUID的variant field is QUuid.DCE。否则返回QUuid.VerUnknown

See also variant( ) 。

bool QUuid.__eq__ (self, QUuid orig)

bool QUuid.__ge__ (self, QUuid other)

bool QUuid.__gt__ (self, QUuid other)

bool QUuid.__le__ (self, QUuid other)

bool QUuid.__lt__ (self, QUuid other)

bool QUuid.__ne__ (self, QUuid orig)

str QUuid.__repr__ (self)




PyQt 4.10.3 for X11 Copyright © Riverbank Computing Ltd and Nokia 2012 Qt 4.8.5