array --- 高效的數值數組?

此模塊定義了一種對象類(lèi)型，可以緊湊地表示基本類(lèi)型值的數組：字符、整數、浮點(diǎn)數等。 數組屬于序列類(lèi)型，其行為與列表非常相似，不同之處在于其中存儲的對象類(lèi)型是受限的。 類(lèi)型在對象創(chuàng )建時(shí)使用單個(gè)字符的 類(lèi)型碼 來(lái)指定。 已定義的類(lèi)型碼如下：

注釋?zhuān)?/p>

1. 由于平臺的不同它可能為 16 位或 32 位。

   在 3.9 版更改: array('u') 現在使用 wchar_t 作為 C 類(lèi)型而不再是已棄用的 Py_UNICODE。 這個(gè)改變不會(huì )影響其行為，因為 Py_UNICODE 自 Python 3.3 起就是 wchar_t 的別名。

   Deprecated since version 3.3, will be removed in version 4.0.

值的實(shí)際表示會(huì )由機器的架構決定（嚴格地說(shuō)是由 C 實(shí)現決定）。 實(shí)際大小可通過(guò) itemsize 屬性來(lái)獲取。

這個(gè)模塊定義了以下類(lèi)型：

class array.array(typecode[, initializer])?

一個(gè)包含由 typecode 限制類(lèi)型的條目的新數組，并由可選的 initializer 值進(jìn)行初始化，該值必須為一個(gè)列表、bytes-like object 或包含正確類(lèi)型元素的可迭代對象。

如果給定一個(gè)列表或字符串，該 initializer 會(huì )被傳給新數組的 fromlist(), frombytes() 或 fromunicode() 方法（見(jiàn)下文）以將初始條目添加到數組中。 否則會(huì )將可迭代對象作為 initializer 傳給 extend() 方法。

引發(fā)一個(gè) 審計事件 array.__new__ 附帶參數 typecode, initializer。

array.typecodes?

一個(gè)包含所有可用類(lèi)型碼的字符串。

數組對象支持普通的序列操作如索引、切片、拼接和重復等。 當使用切片賦值時(shí)，所賦的值必須為具有相同類(lèi)型碼的數組對象；所有其他情況都將引發(fā) TypeError。 數組對象也實(shí)現了緩沖區接口，可以用于所有支持 字節類(lèi)對象 的場(chǎng)合。

以下數據項和方法也受到支持：

array.typecode?

用于創(chuàng )建數組的類(lèi)型碼字符。

array.itemsize?

在內部表示中一個(gè)數組項的字節長(cháng)度。

array.append(x)?

添加一個(gè)值為 x 的新項到數組末尾。

array.buffer_info()?

返回一個(gè)元組 (address, length) 以給出用于存放數組內容的緩沖區元素的當前內存地址和長(cháng)度。 以字節表示的內存緩沖區大小可通過(guò) array.buffer_info()[1] * array.itemsize 來(lái)計算。 這在使用需要內存地址的低層級（因此不夠安全） I/O 接口時(shí)會(huì )很有用，例如某些 ioctl() 操作。 只要數組存在并且沒(méi)有應用改變長(cháng)度的操作，返回數值就是有效的。

備注

當在 C 或 C++ 編寫(xiě)的代碼中使用數組對象時(shí)（這是有效使用此類(lèi)信息的唯一方式），使用數組對象所支持的緩沖區接口更為適宜。 此方法僅保留用作向下兼容，應避免在新代碼中使用。 緩沖區接口的文檔參見(jiàn) 緩沖協(xié)議。

array.byteswap()?

“字節對調”所有數組項。 此方法只支持大小為 1, 2, 4 或 8 字節的值；對于其他值類(lèi)型將引發(fā) RuntimeError。 它適用于從不同字節序機器所生成的文件中讀取數據的情況。

array.count(x)?

返回 x 在數組中的出現次數。

array.extend(iterable)?

將來(lái)自 iterable 的項添加到數組末尾。 如果 iterable 是另一個(gè)數組，它必須具有 完全 相同的類(lèi)型碼；否則將引發(fā) TypeError。 如果 iterable 不是一個(gè)數組，則它必須為可迭代對象并且其元素必須為可添加到數組的適當類(lèi)型。

array.frombytes(s)?

添加來(lái)自字符串的項，將字符串解讀為機器值的數組（相當于使用 fromfile() 方法從文件中讀取數據）。

3.2 新版功能: fromstring() 重命名為 frombytes() 以使其含義更清晰。

array.fromfile(f, n)?

從 file object f 中讀取 n 項并將它們添加到數組末尾。 如果可用數據少于 n 項，則會(huì )引發(fā) EOFError，但可用的項仍然會(huì )被插入數組。

array.fromlist(list)?

添加來(lái)自 list 的項。 這等價(jià)于 for x in list: a.append(x)，區別在于如果發(fā)生類(lèi)型錯誤，數組將不會(huì )被改變。

array.fromunicode(s)?

使用來(lái)自給定 Unicode 字符串的數組擴展數組。 數組必須是類(lèi)型為 'u' 的數組；否則將引發(fā) ValueError。 請使用 array.frombytes(unicodestring.encode(enc)) 來(lái)將 Unicode 數據添加到其他類(lèi)型的數組。

array.index(x[, start[, stop]])?

返回最小的 i 使得 i 為數組中首次出現的 x 的索引號。 指定可選參數 start 和 stop 以便在數組的一個(gè)子部分內部搜索 x。 如果未找到 x 則會(huì )引發(fā) ValueError。

在 3.10 版更改: 添加了可選的 start 和 stop 形參。

array.insert(i, x)?

將值 x 作為新項插入數組的 i 位置之前。 負值將被視為相對于數組末尾的位置。

array.pop([i])?

從數組中移除序號為 i 的項并將其返回。 可選參數值默認為 -1，因此默認將移除并返回末尾項。

array.remove(x)?

從數組中移除首次出現的 x。

array.reverse()?

反轉數組中各項的順序。

array.tobytes()?

將數組轉換為一個(gè)機器值數組并返回其字節表示（即相當與通過(guò) tofile() 方法寫(xiě)入到文件的字節序列。）

3.2 新版功能: tostring() 被重命名為 tobytes() 以使其含義更清晰。

array.tofile(f)?

將所有項（作為機器值）寫(xiě)入到 file object f。

array.tolist()?

將數組轉換為包含相同項的普通列表。

array.tounicode()?

將數組轉換為一個(gè) Unicode 字符串。 數組必須是類(lèi)型為 'u' 的數組；否則將引發(fā) ValueError。 請使用 array.tobytes().decode(enc) 來(lái)從其他類(lèi)型的數組生成 Unicode 字符串。

當一個(gè)數組對象被打印或轉換為字符串時(shí)，它會(huì )表示為 array(typecode, initializer)。 如果數組為空則 initializer 會(huì )被省略，否則如果 typecode 為 'u' 則它是一個(gè)字符串，否則它是一個(gè)數字列表。 使用 eval() 保證能將字符串轉換回具有相同類(lèi)型和值的數組，只要 array 類(lèi)已通過(guò) from array import array 被引入。 例如:

array('l')
array('u', 'hello \u2641')
array('l', [1, 2, 3, 4, 5])
array('d', [1.0, 2.0, 3.14])