源代码: Lib/uuid.py

这个模块提供了不可变的UUID对象(UUID类)和函数uuid1()、uuid3()、uuid4()、uuid5()，用于生成RFC 4122中指定的版本1、3、4和5 UUID。

如果您想要的只是一个唯一的ID，那么可能应该调用uuid1()或uuid4()。注意，uuid1()可能会损害隐私，因为它创建了一个包含计算机网络地址的UUID。uuid4()创建一个随机的UUID。

• class uuid.UUID(hex=None, bytes=None, bytes_le=None, fields=None, int=None, version=None)

创建一个UUID从32个十六进制数字的字符串,字符串16字节的高位优先顺序的字节,16字节的字符串在低位优先顺序bytes_le论点,六元组整数(32位time_low, 16位time_mid、16位time_hi_version 8位clock_seq_hi_variant, 8位clock_seq_low, 48比特位节点)作为字段的参数,或一个128位整数作为int参数。当给定一串十六进制数字时，花括号、连字符和URN前缀都是可选的。

例如，这些表达式都产生相同的UUID:

UUID('{12345678-1234-5678-1234-567812345678}')
UUID('12345678123456781234567812345678')
UUID('urn:uuid:12345678-1234-5678-1234-567812345678')
UUID(bytes=b'\x12\x34\x56\x78'*4)
UUID(bytes_le=b'\x78\x56\x34\x12\x34\x12\x78\x56' +
              b'\x12\x34\x56\x78\x12\x34\x56\x78')
UUID(fields=(0x12345678, 0x1234, 0x5678, 0x12, 0x34, 0x567812345678))
UUID(int=0x12345678123456781234567812345678)

必须给出十六进制、字节、bytes_le、字段或int中的一个。版本参数是可选的;如果给定，结果UUID将根据RFC 4122设置其变体和版本号，覆盖给定十六进制、字节、bytes_le、字段或int中的位。

UUID对象的比较是通过比较它们的UUID.int属性进行的。与非uuid对象进行比较会引发类型错误。

str(uuid)返回格式为12345678-1234-5678-1234-567812345678的字符串，其中32个十六进制数字表示uuid。

UUID实例有以下只读属性:

• UUID.bytes

UUID是一个16字节的字符串(以big-endian字节顺序包含6个整数字段)。

• UUID.bytes_le

UUID是一个16字节的字符串(time_low、time_mid和time_hi_version按低位字节顺序排列)。

• UUID.fields

以元组形式存放的UUID的6个整数域，有六个单独的属性和两个派生属性：

域 含义

time_low UUID的前32位

time_mid 接前一域的16位

time_hi_version 接前一域的16位

clock_seq_hi_variant 接前一域的8位

clock_seq_low 接前一域的8位

node UUID的最后48位

time UUID的总长60位的时间戳

clock_seq 14位的序列号

• UUID.hex

UUID是一个32个字符的十六进制字符串。

• UUID.int

UUID为128位整数。

• UUID.urn

UUID是RFC 4122中指定的URN。

• UUID.variant

UUID变体，它决定UUID的内部布局。这将是一个常量RESERVED_NCS、RFC_4122、RESERVED_MICROSOFT或RESERVED_FUTURE。

• UUID.version

UUID版本号(1到5，只有当变体是RFC_4122时才有意义)。

uuid模块定义了以下功能:

• uuid.getnode()

获取48位正整数的硬件地址。第一次运行时，它可能会启动一个单独的程序，这个程序可能会非常慢。如果所有获取硬件地址的尝试都失败了，我们将随机选择一个48位的数字，并按照RFC 4122中的建议将其8位设置为1。“硬件地址”是指一个网络接口的MAC地址，在具有多个网络接口的机器上，可以返回其中任何一个网络接口的MAC地址。

• uuid.uuid1(node=None, clock_seq=None)

从主机ID、序列号和当前时间生成UUID。如果没有给出节点，则使用getnode()来获取硬件地址。如果给定clock_seq，则使用它作为序列号;否则，一个随机的14位序列号被选择。

• uuid.uuid3(namespace, name)

基于名称空间标识符(即UUID)和名称(即字符串)的MD5散列生成UUID。

• uuid.uuid4()

生成一个随机的UUID。

• uuid.uuid5(namespace, name)

基于名称空间标识符(是UUID)和名称(是字符串)的SHA-1散列生成UUID。

uuid模块定义了以下与uuid3()或uuid5()一起使用的名称空间标识符。

• uuid.NAMESPACE_DNS

指定此名称空间时，名称字符串是完全限定的域名。

• uuid.NAMESPACE_URL

当指定此名称空间时，名称字符串是一个URL。

• uuid.NAMESPACE_OID

当指定此名称空间时，名称字符串是一个ISO OID。

• uuid.NAMESPACE_X500

指定此名称空间时，名称字符串是DER或文本输出格式的X.500 DN。

uuid模块为变体属性的可能值定义了以下常量:

• uuid.RESERVED_NCS

为NCS兼容性保留。

• uuid.RFC_4122

指定RFC 4122中给出的UUID布局。

• uuid.RESERVED_MICROSOFT

保留微软兼容性。

• uuid.RESERVED_FUTURE

预留给以后的定义。

示例

下面是uuid模块的一些典型用法:

>>> import uuid

>>> # make a UUID based on the host ID and current time
>>> uuid.uuid1()
UUID('a8098c1a-f86e-11da-bd1a-00112444be1e')

>>> # make a UUID using an MD5 hash of a namespace UUID and a name
>>> uuid.uuid3(uuid.NAMESPACE_DNS, 'python.org')
UUID('6fa459ea-ee8a-3ca4-894e-db77e160355e')

>>> # make a random UUID
>>> uuid.uuid4()
UUID('16fd2706-8baf-433b-82eb-8c7fada847da')

>>> # make a UUID using a SHA-1 hash of a namespace UUID and a name
>>> uuid.uuid5(uuid.NAMESPACE_DNS, 'python.org')
UUID('886313e1-3b8a-5372-9b90-0c9aee199e5d')

>>> # make a UUID from a string of hex digits (braces and hyphens ignored)
>>> x = uuid.UUID('{00010203-0405-0607-0809-0a0b0c0d0e0f}')

>>> # convert a UUID to a string of hex digits in standard form
>>> str(x)
'00010203-0405-0607-0809-0a0b0c0d0e0f'

>>> # get the raw 16 bytes of the UUID
>>> x.bytes
b'\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f'

>>> # make a UUID from a 16-byte string
>>> uuid.UUID(bytes=x.bytes)
UUID('00010203-0405-0607-0809-0a0b0c0d0e0f')