QBitArray Class

Documentation sur les fonctions membres

[noexcept] QBitArray::QBitArray()

Crée un tableau de bits vide.

Voir aussi isEmpty().

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

Crée un tableau de bits contenant des bits de type « size ». Ces bits sont initialisés avec la valeur « value », dont la valeur par défaut est « false » (0).

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

Crée une copie de ` other`.

Cette opération s'effectue en temps constant, car QBitArray est implicitement partagé. Cela rend très rapide le retour d'un QBitArray depuis une fonction. Si une instance partagée est modifiée, elle sera copiée (copie à l'écriture), ce qui prend un temps linéaire.

Voir également operator=().

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

La fonction `move` crée une instance de `QBitArray` en la faisant pointer vers le même objet que celui vers lequel pointait ` other `.

bool QBitArray::at(qsizetype i) const

Renvoie la valeur du bit situé à l'index i.

i i doit être une position d'index valide dans le tableau de bits (c'est-à-dire que 0 <= < ()). size

Voir également operator[]().

const char *QBitArray::bits() const

Renvoie un pointeur vers un tableau de bits dense correspondant à cette QBitArray. Le comptage des bits s'effectue en partant du bit le moins significatif de chaque octet. Le nombre de bits pertinents dans le dernier octet est indiqué par size() % 8.

Voir également fromBits() et size().

void QBitArray::clear()

Efface le contenu du tableau de bits et le rend vide.

Voir également resize() et isEmpty().

void QBitArray::clearBit(qsizetype i)

Définit le bit situé à l'index i sur 0.

i i doit être une position d'index valide dans le tableau de bits (c'est-à-dire 0 <= < ()). size

Voir également setBit() et toggleBit().

qsizetype QBitArray::count() const

Identique à ` size()`.

qsizetype QBitArray::count(bool on) const

Si la condition « on » est vraie, cette fonction renvoie le nombre de bits à 1 stockés dans le tableau de bits ; dans le cas contraire, elle renvoie le nombre de bits à 0.

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

Définit chaque bit du tableau de bits à la valeur value, et renvoie « true » en cas de réussite ; sinon, renvoie false. Si size est différent de -1 (valeur par défaut), le tableau de bits est préalablement redimensionné à size.

Exemple :

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

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

Voir aussi resize().

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

Définit les bits situés aux positions d'index comprises entre begin et (sans inclure) end sur value.

begin doit être une position d’index valide dans le tableau de bits (0 <= begin < size()).

end doit être soit une position d'index valide, soit égale à size(), auquel cas l'opération de remplissage s'exécute jusqu'à la fin du tableau (0 <= end <= size()).

Exemple :

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)

Crée un tableau de bits dense ( QBitArray ) à partir du tableau de bits dense situé à l'adresse data, avec size bits. Le tableau d'octets situé à l'adresse data doit avoir une longueur d'au moins size / 8 (arrondi à l'unité supérieure) octets.

Si size n'est pas un multiple de 8, cette fonction inclura les bits les plus bas ( size % 8) du dernier octet de data.

Voir également bits().

bool QBitArray::isEmpty() const

Renvoie « true » si ce tableau de bits a une taille de 0 ; sinon, renvoie « false ».

Voir aussi size().

bool QBitArray::isNull() const

Renvoie ` true ` si ce tableau de bits est nul ; sinon, renvoie ` false`.

Exemple :

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

Qt fait la distinction entre les tableaux de bits nuls et les tableaux de bits vides pour des raisons historiques. Pour la plupart des applications, ce qui importe, c'est de savoir si un tableau de bits contient ou non des données, ce qui peut être déterminé à l'aide de isEmpty().

Voir également isEmpty().

void QBitArray::resize(qsizetype size)

Redimensionne le tableau de bits à size bits.

Si size est supérieur à la taille actuelle, le tableau de bits est étendu pour atteindre size bits, les bits supplémentaires étant ajoutés à la fin. Les nouveaux bits sont initialisés à faux (0).

Si size est inférieur à la taille actuelle, des bits sont supprimés à la fin.

Voir également size().

void QBitArray::setBit(qsizetype i)

Définit le bit situé à l'index i sur 1.

i i doit être une position d'index valide dans le tableau de bits (c'est-à-dire 0 <= < ()). size

Voir également clearBit() et toggleBit().

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

Définit le bit situé à l'index i sur la valeur value.

qsizetype QBitArray::size() const

Renvoie le nombre de bits stockés dans le tableau de bits.

Voir aussi resize().

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

Permute cet tableau de bits avec other. Cette opération est très rapide et ne rencontre jamais d'échec.

bool QBitArray::testBit(qsizetype i) const

Renvoie « true » si le bit situé à l'index i est égal à 1 ; sinon, renvoie « false ».

i doit être une position d'index valide dans le tableau de bits (c'est-à-dire 0 <= i < size()).

Voir également setBit() et clearBit().

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

Renvoie le tableau de bits converti en entier. La conversion s'appuie sur endianness. Elle convertit les 32 premiers bits du tableau en quint32 et les renvoie, conformément à endianness. Si ok n'est pas un pointeur nul et que le tableau comporte plus de 32 bits, ok est défini sur false et cette fonction renvoie zéro ; dans le cas contraire, il est défini sur true.

Cette fonction a été introduite dans Qt 6.0.

bool QBitArray::toggleBit(qsizetype i)

Inverse la valeur du bit situé à l'index i, en renvoyant la valeur précédente de ce bit sous la forme « vrai » (s'il était activé) ou « faux » (s'il n'était pas activé).

Si la valeur précédente était 0, la nouvelle valeur sera 1. Si la valeur précédente était 1, la nouvelle valeur sera 0.

i doit être une position d'index valide dans le tableau de bits (c'est-à-dire 0 <= i < size()).

Voir également setBit() et clearBit().

void QBitArray::truncate(qsizetype pos)

Tronque le tableau de bits à l'index pos.

Si pos se trouve au-delà de la fin du tableau, rien ne se passe.

Voir aussi resize().

Effectue l'opération « ET » entre tous les bits de ce tableau de bits et other. Attribue le résultat à ce tableau de bits et renvoie une référence à celui-ci.

Le résultat a la longueur du plus long des deux tableaux de bits, les bits manquants (si un tableau est plus court que l'autre) étant considérés comme égaux à 0.

Exemple :

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 ]

Voir également operator&(), operator|=(), operator^=() et operator~().

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

Déplace le contenu de ` other ` vers ce tableau de bits et renvoie une référence à ce tableau de bits.

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

Attribue la valeur « other » à ce tableau de bits et renvoie une référence à ce tableau de bits.

QBitRef QBitArray::operator[](qsizetype i)

Renvoie le bit situé à l'index i sous forme de référence modifiable.

i i doit être un indice valide dans le tableau de bits (c'est-à-dire 0 <= < ()). size

Exemple :

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

La valeur de retour est de type QBitRef, une classe d'aide pour QBitArray. Lorsque vous obtenez un objet de type QBitRef, vous pouvez lui attribuer une valeur, et cette attribution s'appliquera au bit du tableau QBitArray à partir duquel vous avez obtenu la référence.

Les fonctions testBit(), setBit() et clearBit() sont légèrement plus rapides.

Voir également at(), testBit(), setBit() et clearBit().

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

Effectue l'opération XOR entre tous les bits de ce tableau de bits et other. Attribue le résultat à ce tableau de bits et renvoie une référence à celui-ci.

Le résultat a la longueur du plus long des deux tableaux de bits, les bits manquants (si l'un des tableaux est plus court que l'autre) étant considérés comme des 0.

Exemple :

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 ]

Voir également operator^(), operator&=(), operator|=() et operator~().

Effectue l'opération OR entre tous les bits de ce tableau de bits et other. Attribue le résultat à ce tableau de bits et renvoie une référence à celui-ci.

Le résultat a la longueur du plus long des deux tableaux de bits ; les bits manquants (si un tableau est plus court que l’autre) sont considérés comme étant à 0.

Exemple :

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 ]

Voir également operator|(), operator&=(), operator^=() et operator~().