QBitArray 类

成员函数文档

在位数组中，对这个位数组和other的每个位执行AND操作。将结果赋给这个位数组，并返回对其的引用。

结果长度为两个位数组中最长的，对于较短的数组中缺失的位视为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~()。

在这个位数组和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~()。

在位数组中，对这个位数组和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~()。

[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)

移动构造一个QBitArray实例，使其指向other指向的同一对象。

bool QBitArray::at(qsizetype i) const

返回位索引位置 i 的值。

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

另请参阅操作符[].

const char *QBitArray::bits() const

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

另请参阅fromBits() 和 size.

void QBitArray::clear()

清除位数组的所有内容并使其为空。

另请参阅resize() 和 isEmpty.

void QBitArray::clearBit(qsizetype i)

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

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

另请参阅setBit() 和 toggleBit.

qsizetype QBitArray::count() const

等同于 size.

qsizetype QBitArray::count(bool on) const

如果 on 是 true，则此函数返回位数组中存储的 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 ]

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

创建一个位于 data 的 QBitArray，具有 size 位。位于 data 的字节数组至少需要 size / 8 (向上取整) 字节。

如果 size 不是 8 的倍数，则此函数将包括 data 中最低的 size % 8 位。

另请参阅 bits。

bool QBitArray::isEmpty() const

如果这个位数组大小为0，则返回 true；否则返回 false。

另请参阅 size。

bool QBitArray::isNull() const

如果这个位数组是null，则返回 true；否则返回 false。

示例

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

Qt 为了历史原因，在 null 位数组与空位数组之间进行了区分。对于大多数应用程序来说，重要的是位数组是否包含任何数据，这可以通过 isEmpty() 来确定。

另请参阅isEmpty()。

void QBitArray::resize(qsizetype size)

将位数组的大小调整为 size 位。

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

如果 size 小于当前大小，则从末尾移除位。

另请参阅 size。

void QBitArray::setBit(qsizetype i)

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

i 必须是位数组中的一个有效索引位置（即，0 <= i < 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（设置为1）或为false（未设置）。

如果原始值是0，新值将是1。如果原始值是1，新值将是0。

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

另请参阅 setBit() 和 clearBit。

void QBitArray::truncate(qsizetype pos)

在索引位置pos处截断位数组。

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

另请参阅resize.

bool QBitArray::operator!=(const QBitArray &other) const

如果other与该位数组不相等，则返回true；否则返回false。

另请参阅operator==().

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

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

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

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

bool QBitArray::operator==(const QBitArray &other) const

如果other与此位数组相等，则返回true；否则返回false。

另请参阅operator!=().

QBitRef QBitArray::operator[](qsizetype i)

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

i 必须是位数组中的一个有效索引位置（即，0 <= i < 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

这是一个重载函数。