En esta página

QBitArray Class

La clase QBitArray proporciona una matriz de bits. Más información...

Encabezado: #include <QBitArray>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QBitArray

CategoríaTipos comparables
igualdadQBitArray

Funciones públicas

QBitArray()
QBitArray(qsizetype size, bool value = false)
QBitArray(const QBitArray &other)
QBitArray(QBitArray &&other)
bool at(qsizetype i) const
const char *bits() const
void clear()
void clearBit(qsizetype i)
qsizetype count() const
qsizetype count(bool on) const
bool fill(bool value, qsizetype size = -1)
void fill(bool value, qsizetype begin, qsizetype end)
bool isEmpty() const
bool isNull() const
void resize(qsizetype size)
void setBit(qsizetype i)
void setBit(qsizetype i, bool value)
qsizetype size() const
void swap(QBitArray &other)
bool testBit(qsizetype i) const
(since 6.0) quint32 toUInt32(QSysInfo::Endian endianness, bool *ok = nullptr) const
bool toggleBit(qsizetype i)
void truncate(qsizetype pos)
QBitArray &operator&=(QBitArray &&other)
QBitArray &operator&=(const QBitArray &other)
QBitArray &operator=(QBitArray &&other)
QBitArray &operator=(const QBitArray &other)
QBitRef operator[](qsizetype i)
bool operator[](qsizetype i) const
QBitArray &operator^=(QBitArray &&other)
QBitArray &operator^=(const QBitArray &other)
QBitArray &operator|=(QBitArray &&other)
QBitArray &operator|=(const QBitArray &other)

Miembros públicos estáticos

QBitArray fromBits(const char *data, qsizetype size)
bool operator!=(const QBitArray &lhs, const QBitArray &rhs)
QBitArray operator&(QBitArray &&a1, QBitArray &&a2)
QBitArray operator&(QBitArray &&a1, const QBitArray &a2)
QBitArray operator&(const QBitArray &a1, QBitArray &&a2)
QBitArray operator&(const QBitArray &a1, const QBitArray &a2)
QDataStream &operator<<(QDataStream &out, const QBitArray &ba)
bool operator==(const QBitArray &lhs, const QBitArray &rhs)
QDataStream &operator>>(QDataStream &in, QBitArray &ba)
QBitArray operator^(QBitArray &&a1, QBitArray &&a2)
QBitArray operator^(QBitArray &&a1, const QBitArray &a2)
QBitArray operator^(const QBitArray &a1, QBitArray &&a2)
QBitArray operator^(const QBitArray &a1, const QBitArray &a2)
QBitArray operator|(QBitArray &&a1, QBitArray &&a2)
QBitArray operator|(QBitArray &&a1, const QBitArray &a2)
QBitArray operator|(const QBitArray &a1, QBitArray &&a2)
QBitArray operator|(const QBitArray &a1, const QBitArray &a2)
QBitArray operator~(QBitArray a)

Descripción detallada

Un QBitArray es una matriz que permite acceder a bits individuales y proporciona operadores (AND, OR, XOR y NOT) que operan sobre matrices completas de bits. Utiliza el uso compartido implícito (copia al escribir) para reducir el consumo de memoria y evitar la copia innecesaria de datos.

El siguiente código crea un QBitArray que contiene 200 bits inicializados a falso (0):

QBitArray ba(200);

Para inicializar los bits a «true», basta con pasar « true » como segundo argumento al constructor o llamar posteriormente a « fill()».

QBitArray utiliza índices que comienzan en 0, al igual que las matrices de C++. Para acceder al bit situado en una posición de índice concreta, se puede utilizar el operador [](). En las matrices de bits no const, el operador []() devuelve una referencia a un bit que se puede utilizar en el lado izquierdo de una asignación. Por ejemplo:

QBitArray ba;
ba.resize(3);
ba[0] = true;
ba[1] = false;
ba[2] = true;

Por motivos técnicos, resulta más eficiente utilizar testBit() y setBit() para acceder a los bits del array que el operador [](). Por ejemplo:

QBitArray ba(3);
ba.setBit(0, true);
ba.setBit(1, false);
ba.setBit(2, true);

QBitArray admite & (AND), | (OR), ^ (XOR), ~ (NOT), así como &=, |= y ^=. Estos operadores funcionan de la misma manera que los operadores bit a bit integrados de C++ del mismo nombre. Por ejemplo:

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 ]

Por razones históricas, QBitArray distingue entre una matriz de bits nula y una matriz de bits vacía. Una matriz de bits nula es aquella que se inicializa utilizando el constructor por defecto de QBitArray. Una matriz de bits vacía es cualquier matriz de bits de tamaño 0. Una matriz de bits nula siempre está vacía, pero una matriz de bits vacía no es necesariamente nula:

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

Todas las funciones, excepto ` isNull()`, tratan las matrices de bits nulas igual que las matrices de bits vacías; por ejemplo, `QBitArray()` es equivalente a `QBitArray(0)`. Recomendamos utilizar siempre ` isEmpty()` y evitar ` isNull()`.

Véase también QByteArray y QList.

Documentación de las funciones de miembro

[noexcept] QBitArray::QBitArray()

Crea una matriz de bits vacía.

Véase también isEmpty().

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

Crea una matriz de bits que contiene size bits. Los bits se inicializan con value, cuyo valor por defecto es falso (0).

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

Crea una copia de ` other`.

Esta operación tarda un tiempo constante, ya que QBitArray se comparte implícitamente. Esto hace que devolver un QBitArray desde una función sea muy rápido. Si se modifica una instancia compartida, se copiará (copia al escribir), lo que lleva un tiempo lineal.

Véase también operator=().

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

Move crea una instancia de QBitArray, haciendo que apunte al mismo objeto al que apuntaba other.

bool QBitArray::at(qsizetype i) const

Devuelve el valor del bit situado en la posición de índice i.

i Debe ser una posición de índice válida en la matriz de bits (es decir, 0 <= i < size()).

Véase también ` operator[]()`.

const char *QBitArray::bits() const

Devuelve un puntero a una matriz de bits densa para este QBitArray. Los bits se cuentan en orden ascendente a partir del bit menos significativo de cada byte. El número de bits relevantes en el último byte viene dado por size() % 8.

Véanse también fromBits() y size().

void QBitArray::clear()

Borra el contenido de la matriz de bits y la deja vacía.

Véase también resize() y isEmpty().

void QBitArray::clearBit(qsizetype i)

Establece el bit situado en la posición de índice i en 0.

i Debe ser una posición de índice válida en la matriz de bits (es decir, 0 <= i < size()).

Véanse también setBit() y toggleBit().

qsizetype QBitArray::count() const

Es lo mismo que « size()».

qsizetype QBitArray::count(bool on) const

Si on es verdadero, esta función devuelve el número de bits a 1 almacenados en la matriz de bits; en caso contrario, devuelve el número de bits a 0.

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

Establece todos los bits del array de bits en value y devuelve «true» si la operación se realiza correctamente; en caso contrario, devuelve « false ». Si size es distinto de -1 (el valor por defecto), el tamaño del array de bits se ajusta previamente a size.

Ejemplo:

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

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

Véase también resize().

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

Establece los bits en las posiciones de índice begin hasta (sin incluir) end, pasando por value.

begin Debe ser una posición de índice válida en la matriz de bits (0 <= begin < size()).

end debe ser una posición de índice válida o igual a size(), en cuyo caso la operación de relleno se ejecuta hasta el final de la matriz (0 <= end <= size()).

Ejemplo:

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 ]

Esta es una función sobrecargada.

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

Crea un objeto ` QBitArray ` con la matriz de bits densa ubicada en ` data`, con ` size ` bits. La matriz de bytes situada en ` data ` debe tener una longitud mínima de ` size / 8` (redondeada al alza) bytes.

Si size no es un múltiplo de 8, esta función incluirá los bits más bajos de size % 8 del último byte de data.

Véase también bits().

bool QBitArray::isEmpty() const

Devuelve ` true ` si esta matriz de bits tiene tamaño 0; en caso contrario, devuelve `false`.

Véase también size().

bool QBitArray::isNull() const

Devuelve ` true ` si esta matriz de bits es nula; en caso contrario, devuelve ` false`.

Ejemplo:

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

Qt distingue entre matrices de bits nulas y matrices de bits vacías por razones históricas. Para la mayoría de las aplicaciones, lo que importa es si una matriz de bits contiene datos o no, y esto se puede determinar utilizando isEmpty().

Véase también isEmpty().

void QBitArray::resize(qsizetype size)

Cambia el tamaño de la matriz de bits a size bits.

Si size es mayor que el tamaño actual, la matriz de bits se amplía hasta alcanzar los size bits, añadiendo los bits adicionales al final. Los nuevos bits se inicializan como falsos (0).

Si ` size ` es menor que el tamaño actual, se eliminan bits del final.

Véase también size().

void QBitArray::setBit(qsizetype i)

Establece el bit de la posición de índice i en 1.

i Debe ser una posición de índice válida en la matriz de bits (es decir, 0 <= i < size()).

Véanse también clearBit() y toggleBit().

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

Establece el bit situado en la posición de índice i en value.

Esta es una función sobrecargada.

qsizetype QBitArray::size() const

Devuelve el número de bits almacenados en la matriz de bits.

Véase también resize().

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

Intercambia esta matriz de bits con other. Esta operación es muy rápida y nunca falla.

bool QBitArray::testBit(qsizetype i) const

Devuelve « true » si el bit en la posición de índice « i » es 1; en caso contrario, devuelve « false ».

i debe ser una posición de índice válida en la matriz de bits (es decir, 0 <= i < size()).

Véanse también setBit() y clearBit().

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

Devuelve la matriz de bits convertida a un entero. La conversión se basa en endianness. Convierte hasta los primeros 32 bits de la matriz a quint32 y los devuelve, siguiendo endianness. Si ok no es un puntero nulo y la matriz tiene más de 32 bits, ok se establece en false y esta función devuelve cero; en caso contrario, se establece en true.

Esta función se introdujo en Qt 6.0.

bool QBitArray::toggleBit(qsizetype i)

Invierte el valor del bit situado en la posición de índice i, devolviendo el valor anterior de ese bit como «verdadero» (si estaba activado) o «falso» (si no lo estaba).

Si el valor anterior era 0, el nuevo valor será 1. Si el valor anterior era 1, el nuevo valor será 0.

i debe ser una posición de índice válida en la matriz de bits (es decir, 0 <= i < size()).

Véanse también setBit() y clearBit().

void QBitArray::truncate(qsizetype pos)

Trunca la matriz de bits en la posición de índice pos.

Si pos se encuentra más allá del final de la matriz, no ocurre nada.

Véase también resize().

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

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

Realiza la operación «AND» entre todos los bits de esta matriz de bits y other. Asigna el resultado a esta matriz de bits y devuelve una referencia a la misma.

El resultado tiene la longitud de la más larga de las dos matrices de bits, y los bits que falten (si una matriz es más corta que la otra) se consideran 0.

Ejemplo:

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 ]

Véase también operator&(), operator|=(), operator^=() y operator~().

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

Traslada ` other ` a esta matriz de bits y devuelve una referencia a dicha matriz.

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

Asigna « other » a esta matriz de bits y devuelve una referencia a dicha matriz.

QBitRef QBitArray::operator[](qsizetype i)

Devuelve el bit situado en la posición de índice i como una referencia modificable.

i Debe ser una posición de índice válida en la matriz de bits (es decir, 0 <= i < size()).

Ejemplo:

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

El valor devuelto es de tipo QBitRef, una clase auxiliar para QBitArray. Cuando se obtiene un objeto de tipo QBitRef, se le puede asignar un valor, y la asignación se aplicará al bit de la matriz QBitArray del que se obtuvo la referencia.

Las funciones testBit(), setBit() y clearBit() son ligeramente más rápidas.

Véanse también at(), testBit(), setBit() y clearBit().

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

Esta es una función sobrecargada.

QBitArray &QBitArray::operator^=(QBitArray &&other)

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

Realiza la operación XOR entre todos los bits de esta matriz de bits y other. Asigna el resultado a esta matriz de bits y devuelve una referencia a la misma.

El resultado tiene la longitud de la más larga de las dos matrices de bits, y los bits que falten (si una matriz es más corta que la otra) se consideran 0.

Ejemplo:

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 ]

Véase también operator^(), operator&=(), operator|=() y operator~().

QBitArray &QBitArray::operator|=(QBitArray &&other)

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

Realiza la operación OR entre todos los bits de esta matriz de bits y other. Asigna el resultado a esta matriz de bits y devuelve una referencia a la misma.

El resultado tiene la longitud de la más larga de las dos matrices de bits, y los bits que falten (si una matriz es más corta que la otra) se consideran 0.

Ejemplo:

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 ]

Véase también operator|(), operator&=(), operator^=() y operator~().

Elementos no miembros relacionados

[noexcept] bool operator!=(const QBitArray &lhs, const QBitArray &rhs)

Devuelve ` true ` si ` lhs ` no es igual a la matriz de bits ` rhs `; en caso contrario, devuelve ` false`.

Véase también operator==().

QBitArray operator&(QBitArray &&a1, QBitArray &&a2)

QBitArray operator&(QBitArray &&a1, const QBitArray &a2)

QBitArray operator&(const QBitArray &a1, QBitArray &&a2)

QBitArray operator&(const QBitArray &a1, const QBitArray &a2)

Devuelve una matriz de bits que es el producto «AND» de las matrices de bits a1 y a2.

El resultado tiene la longitud del más largo de los dos matrices de bits, y los bits que falten (si una matriz es más corta que la otra) se consideran 0.

Ejemplo:

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

Véanse también operator&=(), operator|() y operator^().

QDataStream &operator<<(QDataStream &out, const QBitArray &ba)

Escribe la matriz de bits ba en el flujo out.

Véase también Formato de los operadores de QDataStream.

[noexcept] bool operator==(const QBitArray &lhs, const QBitArray &rhs)

Devuelve ` true ` si ` lhs ` es igual a la matriz de bits ` rhs `; en caso contrario, devuelve ` false`.

Véase también operator!=().

QDataStream &operator>>(QDataStream &in, QBitArray &ba)

Lee una matriz de bits en ` ba ` desde el flujo ` in`.

Véase también el formato de los operadores de QDataStream.

QBitArray operator^(QBitArray &&a1, QBitArray &&a2)

QBitArray operator^(QBitArray &&a1, const QBitArray &a2)

QBitArray operator^(const QBitArray &a1, QBitArray &&a2)

QBitArray operator^(const QBitArray &a1, const QBitArray &a2)

Devuelve una matriz de bits que es el resultado de la operación XOR entre las matrices de bits a1 y a2.

El resultado tiene la longitud del más largo de los dos conjuntos de bits, y los bits que falten (si uno de los conjuntos es más corto que el otro) se consideran 0.

Ejemplo:

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

Véase también operator^=().

QBitArray operator|(QBitArray &&a1, QBitArray &&a2)

QBitArray operator|(QBitArray &&a1, const QBitArray &a2)

QBitArray operator|(const QBitArray &a1, QBitArray &&a2)

QBitArray operator|(const QBitArray &a1, const QBitArray &a2)

Devuelve una matriz de bits que es el resultado de la operación OR entre las matrices de bits a1 y a2.

El resultado tiene la longitud del más largo de los dos matrices de bits, y los bits que falten (si una matriz es más corta que la otra) se consideran 0.

Ejemplo:

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

Véase también QBitArray::operator|=(), operator&() y operator^().

QBitArray operator~(QBitArray a)

Devuelve una matriz de bits que contiene los bits invertidos de la matriz de bits a.

Ejemplo:

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

Véase también operator&(), operator|() y operator^().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.