????????此模塊定義了一種對(duì)象類型,可以緊湊地表示基本類型值的數(shù)組:字符离陶、整數(shù)稼虎、浮點(diǎn)數(shù)等。 數(shù)組屬于序列類型招刨,其行為與列表非常相似霎俩,不同之處在于其中存儲(chǔ)的對(duì)象類型是受限的。 類型在對(duì)象創(chuàng)建時(shí)使用單個(gè)字符的類型碼來指定沉眶。已定義的類型碼如下:
注釋:
1.'u' 類型碼對(duì)應(yīng)于 Python 中已過時(shí)的 unicode 字符 (Py_UNICODE 即 wchar_t)打却。 根據(jù)系統(tǒng)平臺(tái)的不同,它可能是 16 位或 32 位谎倔。
?? ?'u' 將與其它的 Py_UNICODE API 一起被移除柳击。
?? ?Deprecated since version 3.3, will be removed in version 4.0.
2.The 'q' and 'Q' type codes are available only if the platform C compiler used to build Python supports C long long, or, on Windows, __int64.
?? ?3.3 新版功能.
?? ?值的實(shí)際表示會(huì)由機(jī)器的架構(gòu)決定(嚴(yán)格地說是由 C 實(shí)現(xiàn)決定)。 實(shí)際大小可通過 itemsize 屬性來獲取片习。
3.’f’?類型float捌肴,‘d’類型double。在IEEE754標(biāo)準(zhǔn)中進(jìn)行了單精度浮點(diǎn)數(shù)(float)和雙精度數(shù)浮點(diǎn)數(shù)(double)的定義藕咏。float有32bit状知,double有64bit。它們的構(gòu)成包括符號(hào)位孽查、指數(shù)位和尾數(shù)位饥悴。
這些位的構(gòu)成如下:
種類-------符號(hào)位-------------指數(shù)位----------------尾數(shù)位----
float---第31位(占1bit)---第30-23位(占8bit)----第22-0位(占23bit)
double--第63位(占1bit)---第62-52位(占11bit)---第51-0位(占52bit)
取值范圍主要看指數(shù)部分:?
float的指數(shù)部分有8bit(2^8),由于是有符號(hào)型盲再,所以得到對(duì)應(yīng)的指數(shù)范圍-128~128西设。?
double的指數(shù)部分有11bit(2^11),由于是有符號(hào)型答朋,所以得到對(duì)應(yīng)的指數(shù)范圍-1024~1024济榨。?
由于float的指數(shù)部分對(duì)應(yīng)的指數(shù)范圍為-128~128,所以取值范圍為:?
-2^128到2^128绿映,約等于-3.4E38 — +3.4E38?
精度(有效數(shù)字)主要看尾數(shù)位:?
float的尾數(shù)位是23bit擒滑,對(duì)應(yīng)7~8位十進(jìn)制數(shù),所以有效數(shù)字有的編譯器是7位叉弦,也有的是8位
這個(gè)模塊定義了以下類型:
class array.array(typecode[, initializer])
?? ??? ?一個(gè)包含由 typecode 限制類型的條目的新數(shù)組丐一,并由可選的 initializer 值進(jìn)行初始化,該值必須為一個(gè)列表淹冰、bytes-like object 或包含正確類型元素的可迭代對(duì)象库车。
?? ??? ?如果給定一個(gè)列表或字符串,該 initializer 會(huì)被傳給新數(shù)組的 fromlist(), frombytes() 或 fromunicode() 方法(見下文)以將初始條目添加到數(shù)組中樱拴。?
?? ??? ?否則會(huì)將可迭代對(duì)象作為 initializer 傳給extend() 方法柠衍。
?? ??? ?array.typecodes
?? ??? ??? ?一個(gè)包含所有可用類型碼的字符串洋满。
?? ??? ??? ?數(shù)組對(duì)象支持普通的序列操作如索引、切片珍坊、拼接和重復(fù)等牺勾。 當(dāng)使用切片賦值時(shí),所賦的值必須為具有相同類型碼的數(shù)組對(duì)象阵漏;所有其他情況都將引發(fā) TypeError驻民。?
?? ??? ??? ?數(shù)組對(duì)象也實(shí)現(xiàn)了緩沖區(qū)接口,可以用于所有支持 字節(jié)類對(duì)象 的場(chǎng)合履怯。
以下數(shù)據(jù)項(xiàng)和方法也受到支持:
?? ??? ?array.typecode
?? ??? ??? ??? ?用于創(chuàng)建數(shù)組的類型碼字符回还。
?? ??? ?array.itemsize
?? ??? ??? ??? ?在內(nèi)部表示中一個(gè)數(shù)組項(xiàng)的字節(jié)長(zhǎng)度。
?? ??? ?array.append(x)
?? ??? ??? ??? ?添加一個(gè)值為 x 的新項(xiàng)到數(shù)組末尾叹洲。
?? ??? ?array.buffer_info()
?? ??? ??? ??? ?返回一個(gè)元組 (address, length) 以給出用于存放數(shù)組內(nèi)容的緩沖區(qū)元素的當(dāng)前內(nèi)存地址和長(zhǎng)度柠硕。?
?? ??? ??? ??? ?以字節(jié)表示的內(nèi)存緩沖區(qū)大小可通過 array.buffer_info()[1] * array.itemsize 來計(jì)算。?
?? ??? ??? ??? ?這在使用需要內(nèi)存地址的低層級(jí)(因此不夠安全) I/O 接口時(shí)會(huì)很有用运提,例如某些 ioctl() 操作仅叫。?
?? ??? ??? ??? ?只要數(shù)組存在并且沒有應(yīng)用改變長(zhǎng)度的操作,返回?cái)?shù)值就是有效的糙捺。
注解:
?? ??? ??? ??? ??? ?當(dāng)在 C 或 C++ 編寫的代碼中使用數(shù)組對(duì)象時(shí)(這是有效使用此類信息的唯一方式),使用數(shù)組對(duì)象所支持的緩沖區(qū)接口更為適宜笙隙。?
?? ??? ??? ??? ??? ?此方法僅保留用作向下兼容洪灯,應(yīng)避免在新代碼中使用。 緩沖區(qū)接口的文檔參見 緩沖協(xié)議竟痰。
array.byteswap()
?? ??? ??? ??? ??? ?“字節(jié)對(duì)調(diào)”所有數(shù)組項(xiàng)签钩。 此方法只支持大小為 1, 2, 4 或 8 字節(jié)的值;對(duì)于其他值類型將引發(fā) RuntimeError坏快。?
?? ??? ??? ??? ??? ?它適用于從不同字節(jié)序機(jī)器所生成的文件中讀取數(shù)據(jù)的情況铅檩。
array.count(x)
?? ??? ??? ??? ??? ?返回 x 在數(shù)組中的出現(xiàn)次數(shù)。
?array.extend(iterable)
?? ??? ??? ??? ??? ?將來自 iterable 的項(xiàng)添加到數(shù)組末尾莽鸿。?
?? ??? ??? ??? ??? ?如果 iterable 是另一個(gè)數(shù)組昧旨,它必須具有 完全 相同的類型碼;否則將引發(fā) TypeError祥得。?
?? ??? ??? ??? ??? ?如果 iterable 不是一個(gè)數(shù)組兔沃,則它必須為可迭代對(duì)象并且其元素必須為可添加到數(shù)組的適當(dāng)類型。
?array.frombytes(s)
?? ??? ??? ??? ??? ?添加來自字符串的項(xiàng)级及,將字符串解讀為機(jī)器值的數(shù)組(相當(dāng)于使用 fromfile() 方法從文件中讀取數(shù)據(jù))乒疏。
?? ??? ??? ??? ??? ?3.2 新版功能: fromstring() 重命名為 frombytes() 以使其含義更清晰。
?array.fromfile(f, n)
?? ??? ??? ??? ??? ?從 file object f 中讀取 n 項(xiàng)(解讀為機(jī)器值)并將它們添加到數(shù)組末尾饮焦。 如果可讀取數(shù)據(jù)少于 n 項(xiàng)則將引發(fā) EOFError怕吴,
?? ??? ??? ??? ??? ?但有效的項(xiàng)仍然會(huì)被插入數(shù)組窍侧。 f 必須為一個(gè)真實(shí)的內(nèi)置文件對(duì)象;不支持帶有 read() 方法的其它對(duì)象转绷。
?array.fromlist(list)
?? ??? ??? ??? ??? ?添加來自 list 的項(xiàng)伟件。 這等價(jià)于 for x in list: a.append(x),區(qū)別在于如果發(fā)生類型錯(cuò)誤暇咆,數(shù)組將不會(huì)被改變锋爪。
array.fromstring()
已棄用的 frombytes() 的別名。
array.fromunicode(s)
?? ??? ??? ??? ??? ?使用來自給定 Unicode 字符串的數(shù)組擴(kuò)展數(shù)組爸业。 數(shù)組必須是類型為 'u' 的數(shù)組其骄;否則將引發(fā) ValueError。?
?? ??? ??? ??? ??? ?請(qǐng)使用 array.frombytes(unicodestring.encode(enc)) 來將 Unicode 數(shù)據(jù)添加到其他類型的數(shù)組扯旷。
?array.index(x)
?? ??? ??? ??? ??? ?返回最小的 i 使得 i 為 x 在數(shù)組中首次出現(xiàn)的序號(hào)拯爽。
array.insert(i, x)
?? ??? ??? ??? ??? ?將值 x 作為新項(xiàng)插入數(shù)組的 i 位置之前。 負(fù)值將被視為相對(duì)于數(shù)組末尾的位置钧忽。
?array.pop([i])
?? ??? ??? ??? ??? ?從數(shù)組中移除序號(hào)為 i 的項(xiàng)并將其返回毯炮。 可選參數(shù)值默認(rèn)為 -1,因此默認(rèn)將移除并返回末尾項(xiàng)耸黑。
?array.remove(x)
?? ??? ??? ??? ??? ?從數(shù)組中移除首次出現(xiàn)的 x桃煎。
?array.reverse()
?? ??? ??? ??? ??? ?反轉(zhuǎn)數(shù)組中各項(xiàng)的順序。
array.tobytes()
?? ??? ??? ??? ??? ?將數(shù)組轉(zhuǎn)換為一個(gè)機(jī)器值數(shù)組并返回其字節(jié)表示(即相當(dāng)與通過 tofile() 方法寫入到文件的字節(jié)序列大刊。)
?? ??? ??? ??? ??? ?3.2 新版功能: tostring() 被重命名為 tobytes() 以使其含義更清晰为迈。
array.tofile(f)
?? ??? ??? ??? ??? ?將所有項(xiàng)(作為機(jī)器值)寫入到 file object f。
?array.tolist()
?? ??? ??? ??? ??? ?將數(shù)組轉(zhuǎn)換為包含相同項(xiàng)的普通列表缺菌。
?? ??? ??? ?array.tostring()
?tobytes() 的已棄用別名葫辐。
?? ??? ??? ?array.tounicode()
?? ??? ??? ??? ??? ?將數(shù)組轉(zhuǎn)換為一個(gè) Unicode 字符串。 數(shù)組必須是類型為 'u' 的數(shù)組伴郁;否則將引發(fā) ValueError耿战。?
?? ??? ??? ??? ??? ?請(qǐng)使用 array.tobytes().decode(enc) 來從其他類型的數(shù)組生成 Unicode 字符串。
?? ??? ??? ??? ??? ?當(dāng)一個(gè)數(shù)組對(duì)象被打印或轉(zhuǎn)換為字符串時(shí)焊傅,它會(huì)表示為 array(typecode, initializer)剂陡。?
?? ??? ??? ??? ??? ?如果數(shù)組為空則 initializer 會(huì)被省略,否則如果 typecode 為 'u' 則它是一個(gè)字符串狐胎,否則它是一個(gè)數(shù)字列表鹏倘。?
?? ??? ??? ??? ??? ?使用 eval() 保證能將字符串轉(zhuǎn)換回具有相同類型和值的數(shù)組,只要 array 類已通過 from array import array 被引入顽爹。?