源代碼: 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')