QBitArray Class

成员函数文档

[noexcept] QBitArray::QBitArray()

构建一个空位数组。

另请参阅 isEmpty()。

[explicit] QBitArray::QBitArray(qsizetype size, bool value = false)

构建一个包含size 个位的位数组。这些位初始化为value ，其默认值为false（0）。

[noexcept] QBitArray::QBitArray(const QBitArray &other)

构建other 的副本。

此操作耗时为常数时间，因为 QBitArray 是隐式共享的。这使得从函数中返回一个 QBitArray 非常快。如果修改了共享的实例，则会进行复制（写时复制），这需要线性时间。

另请参阅 operator=()。

[noexcept] QBitArray::QBitArray(QBitArray &&other)

通过“move”操作构造一个 QBitArray 实例，使其指向与other 原本指向的同一对象。

bool QBitArray::at(qsizetype i) const

返回索引位置i 处的位值。

i i 必须是位数组中的有效索引位置（即 0 <= < ())。size

另请参阅 operator[]()。

const char *QBitArray::bits() const

返回指向该QBitArray 的密集位数组的指针。位数从每个字节的最低有效位开始向上计数。最后一个字节中相关的位数由size() % 8 给出。

另请参阅 fromBits() 和size()。

void QBitArray::clear()

清除位数组的内容，使其变为空。

另请参阅 resize() 和isEmpty()。

void QBitArray::clearBit(qsizetype i)

将索引位置为i 的位设置为 0。

i i 必须是位数组中的有效索引位置（即 0 <= < ())。size

另请参见 setBit() 和toggleBit()。

qsizetype QBitArray::count() const

与size() 相同。

qsizetype QBitArray::count(bool on) const

如果 `on ` 为真，则该函数返回位数组中存储的 1 位的数量；否则返回 0 位的数量。

bool QBitArray::fill(bool value, qsizetype size = -1)

将位数组中的每个位设置为value ，成功时返回true；否则返回false 。如果size 不为-1（默认值），则会事先将位数组调整为size 的大小。

示例：

QBitArray ba(8);
ba.fill(true);
// ba: [ 1, 1, 1, 1, 1, 1, 1, 1 ]

ba.fill(false, 2);
// ba: [ 0, 0 ]

另请参阅 resize()。

void QBitArray::fill(bool value, qsizetype begin, qsizetype end)

将索引位置从begin 到end （不包括 ）处的位设置为value 。

begin 必须是位数组中的有效索引位置（0 <=begin <size())。

end 必须是有效的索引位置，或者等于size()；在后一种情况下，填充操作将运行至数组末尾（0 <=end <=size()）。

示例：

QBitArray ba(4);
ba.fill(true, 1, 2);            // ba: [ 0, 1, 0, 0 ]
ba.fill(true, 1, 3);            // ba: [ 0, 1, 1, 0 ]
ba.fill(true, 1, 4);            // ba: [ 0, 1, 1, 1 ]

[static] QBitArray QBitArray::fromBits(const char *data, qsizetype size)

创建一个QBitArray ，其密集位数组位于data ，包含size 个位。位于data 的字节数组长度必须至少为size /8（向上取整）字节。

如果size 不是 8 的倍数，则该函数将包含data 中最后一个字节的size % 8 位。

另请参阅 bits()。

bool QBitArray::isEmpty() const

如果该位数组的大小为 0，则返回 `true `；否则返回 `false`。

另请参见 size()。

bool QBitArray::isNull() const

如果该位数组为空，则返回true ；否则返回false 。

示例：

QBitArray().isNull();           // returns true
QBitArray(0).isNull();          // returns false
QBitArray(3).isNull();          // returns false

出于历史原因，Qt 将空位图与空位图区分开来。对于大多数应用程序而言，关键在于位图是否包含任何数据，这可以通过isEmpty() 来判断。

另请参阅 isEmpty()。

void QBitArray::resize(qsizetype size)

将位数组调整为size 位。

如果size 大于当前大小，则将位数组扩展为size 位，并将额外位添加到末尾。新位被初始化为 false（0）。

如果size 小于当前大小，则从末尾删除相应数量的位。

另请参阅 size()。

void QBitArray::setBit(qsizetype i)

将索引位置为i 的位设置为 1。

i i 必须是位数组中的有效索引位置（即 0 <= < ())。size

另请参阅 clearBit() 和toggleBit()。

void QBitArray::setBit(qsizetype i, bool value)

将索引位置为i 的位设置为value 。

qsizetype QBitArray::size() const

返回位数组中存储的位数。

另请参阅 resize()。

[noexcept] void QBitArray::swap(QBitArray &other)

将该位数组与other 互换。此操作速度极快，且绝不会失败。

bool QBitArray::testBit(qsizetype i) const

如果索引位置i 处的位为 1，则返回true ；否则返回false 。

i 必须是位数组中的有效索引位置（即 0 <=i <size())。

另请参见 setBit() 和clearBit()。

[noexcept, since 6.0] quint32 QBitArray::toUInt32(QSysInfo::Endian endianness, bool *ok = nullptr) const

返回将位数组转换为整数的数组。 该转换基于endianness 。将数组的前 32 位转换为quint32 并返回，同时遵循endianness 。如果ok 不是空指针，且数组超过 32 位，则ok 被设置为 false，且本函数返回零；否则，将其设置为 true。

该函数在 Qt 6.0 中引入。

bool QBitArray::toggleBit(qsizetype i)

将索引位置为i 的位值进行反转，并返回该位的先前值：若先前已设置，则返回true；若先前未设置，则返回false。

如果先前值为 0，则新值为 1；如果先前值为 1，则新值为 0。

i i 必须是位数组中的有效索引位置（即 0 <= < ())。size

另请参阅 setBit() 和clearBit()。

void QBitArray::truncate(qsizetype pos)

截断索引位置为pos 处的位数组。

如果 `pos ` 超出数组末尾，则不执行任何操作。

另请参阅 resize()。

对该位数组中的所有位与other 进行“与”运算。将结果赋值给该位数组，并返回对其的引用。

结果的长度为两个位数组中最长的一个，若其中一个数组较短，则缺失的位将被视为 0。

示例：

QBitArray a(3);
QBitArray b(2);
a[0] = 1; a[1] = 0; a[2] = 1;   // a: [ 1, 0, 1 ]
b[0] = 1; b[1] = 1;             // b: [ 1, 1 ]
a &= b;                         // a: [ 1, 0, 0 ]

另请参阅 operator&()、operator|=()、operator^=() 以及operator~()。

[noexcept] QBitArray &QBitArray::operator=(QBitArray &&other)

将other 移动到该位数组中，并返回该位数组的引用。

[noexcept] QBitArray &QBitArray::operator=(const QBitArray &other)

将other 赋值给此位数组，并返回对此位数组的引用。

QBitRef QBitArray::operator[](qsizetype i)

返回索引位置i 处的位，作为可修改的引用。

i i 必须是位数组中的有效索引位置（即 0 <= < ())。size

示例：

QBitArray a(3);
a[0] = false;
a[1] = true;
a[2] = a[0] ^ a[1];

返回值的类型为 QBitRef，这是QBitArray 的辅助类。当您获得一个 QBitRef 类型的对象时，可以对其进行赋值，该赋值将作用于您从中获取引用时的QBitArray 中的该位。

函数testBit()、setBit() 和clearBit() 的执行速度略快。

另请参阅 at()、testBit()、setBit() 以及clearBit()。

bool QBitArray::operator[](qsizetype i) const

对该位数组中的所有位与other 进行异或（XOR）运算。将结果赋值给该位数组，并返回对其的引用。

结果的长度等于两个位数组中较长的一个，若有缺失的位（当一个数组比另一个短时），则将其视为 0。

示例：

QBitArray a(3);
QBitArray b(2);
a[0] = 1; a[1] = 0; a[2] = 1;   // a: [ 1, 0, 1 ]
b[0] = 1; b[1] = 1;             // b: [ 1, 1 ]
a ^= b;                         // a: [ 0, 1, 1 ]

另请参阅 operator^()、operator&=()、operator|=() 以及operator~()。

对该位数组中的所有位与other 进行或（OR）运算。将结果赋值给该位数组，并返回对其的引用。

结果的长度等于两个位数组中较长的一个，若有缺失的位（当其中一个数组比另一个短时），则将其视为 0。

示例：

QBitArray a(3);
QBitArray b(2);
a[0] = 1; a[1] = 0; a[2] = 1;   // a: [ 1, 0, 1 ]
b[0] = 1; b[1] = 1;             // b: [ 1, 1 ]
a |= b;                         // a: [ 1, 1, 1 ]

另请参阅 operator|()、operator&=()、operator^=() 以及operator~()。