QBitArray Class Reference · PyQt4 中文文檔

# QBitArray Class Reference ## [[QtCore](index.htm) module] 該QBitArray類提供了一組位。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, int?size, bool?value?=?False)` * `__init__ (self, QBitArray?other)` * `bool at (self, int?i)` * `clear (self)` * `clearBit (self, int?i)` * `int count (self)` * `int count (self, bool?on)` * `detach (self)` * `fill (self, bool?val, int?first, int?last)` * `bool fill (self, bool?value, int?size?=?-1)` * `bool isDetached (self)` * `bool isEmpty (self)` * `bool isNull (self)` * `resize (self, int?size)` * `setBit (self, int?i)` * `setBit (self, int?i, bool?val)` * `int size (self)` * `swap (self, QBitArray?other)` * `bool testBit (self, int?i)` * `bool toggleBit (self, int?i)` * `truncate (self, int?pos)` ### Special Methods * `QBitArray __and__ (self, QBitArray)` * `bool __eq__ (self, QBitArray?a)` * `bool __getitem__ (self, int?i)` * `int __hash__ (self)` * `QBitArray __iand__ (self, QBitArray)` * `QBitArray __invert__ (self)` * `QBitArray __ior__ (self, QBitArray)` * `QBitArray __ixor__ (self, QBitArray)` * `__len__ (self)` * `bool __ne__ (self, QBitArray?a)` * `QBitArray __or__ (self, QBitArray)` * `QBitArray __xor__ (self, QBitArray)` * * * ## Detailed Description 該QBitArray類提供了一組位。一個QBitArray是一個數組，它可以訪問各個位，并提供運營商（[AND](qbitarray.html#operator-and)，[OR](qbitarray.html#operator-7c)，[XOR](qbitarray.html#operator-5e)和[NOT](qbitarray.html#operator-7e)對位的整個數組）的工作。它使用[implicit sharing](index.htm)（復制上寫的），以減少內存使用量，避免不必要的數據復制。下面的代碼創建一個包含200位的QBitArray初始化為False （ 0 ）： ``` QBitArray ba(200); ``` 要初始化位為True ，要么通過`true`作為第二個參數的構造函數，或調用[fill](qbitarray.html#fill)（）以后。 QBitArray使用基于0的索引，就像C + +中的數組。要訪問該位在特定索引位置，可以使用操作符[] （）。對非const位陣列，操作符[ ] （）返回一個引用位，可以在賦值的左側使用。例如： ``` QBitArray ba; ba.resize(3); ba[0] = true; ba[1] = false; ba[2] = true; ``` 由于技術原因，它是更有效地使用[testBit](qbitarray.html#testBit)（）和[setBit](qbitarray.html#setBit)（）來訪問數組比運營商的位[] （）。例如： ``` QBitArray ba(3); ba.setBit(0, true); ba.setBit(1, false); ba.setBit(2, true); ``` QBitArray支持`&`（[AND](qbitarray.html#operator-and)），`|`（[OR](qbitarray.html#operator-7c)），`^`（[XOR](qbitarray.html#operator-5e)），`~`（[NOT](qbitarray.html#operator-7e)），以及`&=`，`|=`和`^=`。這些運營商在相同的方式相同名稱的內置C + +的位運算符的工作。例如： ``` QBitArray x(5); x.setBit(3, true); // x: [ 0, 0, 0, 1, 0 ] QBitArray y(5); y.setBit(4, true); // y: [ 0, 0, 0, 0, 1 ] x |= y; // x: [ 0, 0, 0, 1, 1 ] ``` 由于歷史原因， QBitArray一個空位陣列和一個空的位陣列之間的區別。一_null_位陣列是使用QBitArray的默認構造函數初始化一個位陣列。一個_empty_位陣列中的任何位數組大小為0 。空陣位總是空的，但一個空的位陣列不一定空： ``` QBitArray().isNull(); // returns true QBitArray().isEmpty(); // returns true QBitArray(0).isNull(); // returns false QBitArray(0).isEmpty(); // returns true QBitArray(3).isNull(); // returns false QBitArray(3).isEmpty(); // returns false ``` 之外的全部功能[isNull](qbitarray.html#isNull)（）把空位陣列一樣空位陣列，例如，[QBitArray](qbitarray.html#QBitArray)（）比較等于QBitArray （0）。我們建議您始終使用[isEmpty](qbitarray.html#isEmpty)（）和避免[isNull](qbitarray.html#isNull)（）。 * * * ## Method Documentation ``` QBitArray.__init__ (self) ``` 構造一個空數組位。 **See also** [isEmpty](qbitarray.html#isEmpty)（）。 ``` QBitArray.__init__ (self, int?size, bool?value?=?False) ``` 構造一個位陣列包含_size_位。該位與初始化_value_，默認為False （ 0 ）。 ``` QBitArray.__init__ (self, QBitArray?other) ``` 構造的副本_other_。該操作需要[constant time](index.htm#constant-time)，因為[QBitArray](qbitarray.html) is [implicitly shared](index.htm#implicitly-shared)。這使得返回一個[QBitArray](qbitarray.html)從非常快的函數。如果共享的實例被改性時，其將被復制（復制寫入時），而這需要[linear time](index.htm#linear-time)。 **See also** [operator=](qbitarray.html#operator-eq)（）。 ``` bool QBitArray.at (self, int?i) ``` 返回索引位置的位值_i_。 _i_必須是位陣列中的一個有效的索引位置（即0 \u003c =_i_\u003c[size](qbitarray.html#size)（））。 **See also** [operator[]](qbitarray.html#operator-5b-5d)（）。 ``` QBitArray.clear (self) ``` 清除該位陣列的內容，并使其為空。 **See also** [resize](qbitarray.html#resize)（）和[isEmpty](qbitarray.html#isEmpty)（）。 ``` QBitArray.clearBit (self, int?i) ``` 設置位索引位置_i_為0。 _i_必須是位陣列中的一個有效的索引位置（即0 \u003c =_i_\u003c[size](qbitarray.html#size)（））。 **See also** [setBit](qbitarray.html#setBit)（）和[toggleBit](qbitarray.html#toggleBit)（）。 ``` int QBitArray.count (self) ``` 同[size](qbitarray.html#size)（）。 ``` int QBitArray.count (self, bool?on) ``` If _on_誠然，此函數返回所存儲的比特數組中1位的號碼，否則返回0位的數量。 ``` QBitArray.detach (self) ``` ``` QBitArray.fill (self, bool?val, int?first, int?last) ``` 設置該位陣列中每一個位_value_如果成功，則返回True ，否則返回False 。如果_size_是從-1 （默認值）不同，該位陣列大小調整為_size_事前。例如： ``` [QBitArray](qbitarray.html) ba(8); ba.fill(true); // ba: [ 1, 1, 1, 1, 1, 1, 1, 1 ] ba.fill(false, 2); // ba: [ 0, 0 ] ``` **See also** [resize](qbitarray.html#resize)（）。 ``` bool QBitArray.fill (self, bool?value, int?size?=?-1) ``` 這是一個重載函數。設置位在索引位置_begin_達，但不包括_end_至_value_。 _begin_和_end_必須是位陣列中的一個有效的索引位置（即0 \u003c =_begin_\u003c =[size](qbitarray.html#size)（）和0 \u003c=_end_\u003c =[size](qbitarray.html#size)（））。 ``` bool QBitArray.isDetached (self) ``` ``` bool QBitArray.isEmpty (self) ``` 返回True如果該位數組的大小為0 ，否則返回False 。 **See also** [size](qbitarray.html#size)（）。 ``` bool QBitArray.isNull (self) ``` 返回True如果該位數組為null ，否則返回False 。例如： ``` [QBitArray](qbitarray.html)().isNull(); // returns true [QBitArray](qbitarray.html)(0).isNull(); // returns false [QBitArray](qbitarray.html)(3).isNull(); // returns false ``` Qt后，由于歷史的原因空位陣列和空bit數組之間的區別。對于大多數應用來說，重要的是一個位陣列中是否包含任何數據，這可以通過確定[isEmpty](qbitarray.html#isEmpty)（）。 **See also** [isEmpty](qbitarray.html#isEmpty)（）。 ``` QBitArray.resize (self, int?size) ``` 調整大小的位陣列_size_位。 If _size_大于該電流的大小，位陣列被擴展以使其_size_與額外的比特位添加到末尾。新的位被初始化為False （ 0 ）。 If _size_小于該電流的大小，比特被從端部除去。 **See also** [size](qbitarray.html#size)（）。 ``` QBitArray.setBit (self, int?i) ``` 設置位索引位置_i_為1。 _i_必須是位陣列中的一個有效的索引位置（即0 \u003c =_i_\u003c[size](qbitarray.html#size)（））。 **See also** [clearBit](qbitarray.html#clearBit)（）和[toggleBit](qbitarray.html#toggleBit)（）。 ``` QBitArray.setBit (self, int?i, bool?val) ``` 這是一個重載函數。設置位索引位置_i_至_value_。 ``` int QBitArray.size (self) ``` 返回所存儲的比特陣列中的比特數。 **See also** [resize](qbitarray.html#resize)（）。 ``` QBitArray.swap (self, QBitArray?other) ``` 掉期位陣列_other_與此位陣列。這個操作是非常快的，而且永遠不會。此功能被引入Qt的4.8 。 ``` bool QBitArray.testBit (self, int?i) ``` 返回True ，如果該位索引位置_i_為1 ，否則返回False 。 _i_必須是位陣列中的一個有效的索引位置（即0 \u003c =_i_\u003c[size](qbitarray.html#size)（））。 **See also** [setBit](qbitarray.html#setBit)（）和[clearBit](qbitarray.html#clearBit)（）。 ``` bool QBitArray.toggleBit (self, int?i) ``` 反轉索引位置的位值_i_，返回該位為任一真（如果它被設置）或False （如果它是未設置）的前一個值。如果以前的值為0 ，則新值將是1 。如果以前的值為1 ，新值將為0 。 _i_必須是位陣列中的一個有效的索引位置（即0 \u003c =_i_\u003c[size](qbitarray.html#size)（））。 **See also** [setBit](qbitarray.html#setBit)（）和[clearBit](qbitarray.html#clearBit)（）。 ``` QBitArray.truncate (self, int?pos) ``` 截斷位陣列索引位置_pos_。 If _pos_超出了數組的結尾，沒有任何反應。 **See also** [resize](qbitarray.html#resize)（）。 ``` QBitArray QBitArray.__and__ (self, QBitArray) ``` [ ``` bool QBitArray.__eq__ (self, QBitArray?a) ``` ``` bool QBitArray.__getitem__ (self, int?i) ``` ``` int QBitArray.__hash__ (self) ``` ](qbitarray.html) ``` QBitArray QBitArray.__iand__ (self, QBitArray) ``` [](qbitarray.html) ``` QBitArray QBitArray.__invert__ (self) ``` [](qbitarray.html) ``` QBitArray QBitArray.__ior__ (self, QBitArray) ``` [](qbitarray.html) ``` QBitArray QBitArray.__ixor__ (self, QBitArray) ``` [ ``` QBitArray.__len__ (self) ``` ``` bool QBitArray.__ne__ (self, QBitArray?a) ``` ](qbitarray.html) ``` QBitArray QBitArray.__or__ (self, QBitArray) ``` [](qbitarray.html) ``` QBitArray QBitArray.__xor__ (self, QBitArray) ``` [](qbitarray.html)