QBitArray Class

Dokumentation zu Mitgliedsfunktionen

[noexcept] QBitArray::QBitArray()

Erstellt ein leeres Bit-Array.

Siehe auch ` isEmpty()`.

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

Erstellt ein Bit-Array, das „ size “ Bits enthält. Die Bits werden mit „ value “ initialisiert, dessen Standardwert „false“ (0) ist.

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

Erstellt eine Kopie von ` other`.

Dieser Vorgang dauert eine konstante Zeit, da `QBitArray` implizit gemeinsam genutzt wird. Dadurch ist die Rückgabe eines `QBitArray` aus einer Funktion sehr schnell. Wird eine gemeinsam genutzte Instanz geändert, wird sie kopiert (Copy-on-Write), was lineare Zeit in Anspruch nimmt.

Siehe auch ` operator=()`.

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

Erstellt eine QBitArray-Instanz per Move-Konstruktion, sodass diese auf dasselbe Objekt verweist, auf das zuvor other verwiesen hat.

bool QBitArray::at(qsizetype i) const

Gibt den Wert des Bits an der Indexposition i zurück.

i muss eine gültige Indexposition im Bit-Array sein (d. h. 0 <= i < size()).

Siehe auch ` operator[]()`.

const char *QBitArray::bits() const

Gibt einen Zeiger auf ein dichtes Bit-Array für dieses QBitArray zurück. Die Bits werden in jedem Byte vom niedrigstwertigen Bit aus nach oben gezählt. Die Anzahl der relevanten Bits im letzten Byte ergibt sich aus size() % 8.

Siehe auch fromBits() und size().

void QBitArray::clear()

Löscht den Inhalt des Bit-Arrays und macht es leer.

Siehe auch resize() und isEmpty().

void QBitArray::clearBit(qsizetype i)

Setzt das Bit an der Indexposition i auf 0.

i muss eine gültige Indexposition im Bit-Array sein (d. h., 0 <= i < size()).

Siehe auch setBit() und toggleBit().

qsizetype QBitArray::count() const

Entspricht „ size()“.

qsizetype QBitArray::count(bool on) const

Wenn „ on “ wahr ist, gibt diese Funktion die Anzahl der im Bit-Array gespeicherten 1-Bits zurück; andernfalls wird die Anzahl der 0-Bits zurückgegeben.

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

Setzt jedes Bit im Bit-Array auf „ value “ und gibt bei Erfolg „true“ zurück; andernfalls wird „ false “ zurückgegeben. Wenn „ size “ ungleich -1 (Standardwert) ist, wird das Bit-Array zuvor auf „ size “ angepasst.

Beispiel:

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

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

Siehe auch resize().

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

Setzt die Bits an den Indexpositionen begin bis einschließlich (jedoch nicht einschließlich) end auf value.

begin muss eine gültige Indexposition im Bit-Array sein (0 <= begin < size()).

end muss entweder eine gültige Indexposition sein oder gleich size() sein; in diesem Fall läuft die Fülloperation bis zum Ende des Arrays (0 <= end <= size()).

Beispiel:

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)

Erzeugt ein ` QBitArray ` mit dem dichten Bit-Array unter der Adresse ` data`, das ` size ` Bits enthält. Das Byte-Array unter der Adresse ` data ` muss mindestens ` size / 8` (aufgerundet) Bytes lang sein.

Wenn „ size “ kein Vielfaches von 8 ist, berücksichtigt diese Funktion die untersten „ size % 8“ Bits des letzten Bytes in „ data “.

Siehe auch bits().

bool QBitArray::isEmpty() const

Gibt „ true “ zurück, wenn dieses Bit-Array die Größe 0 hat; andernfalls wird „false“ zurückgegeben.

Siehe auch ` size()`.

bool QBitArray::isNull() const

Gibt „ true “ zurück, wenn dieses Bit-Array null ist; andernfalls wird „ false “ zurückgegeben.

Beispiel:

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

Qt unterscheidet aus historischen Gründen zwischen null-Bit-Arrays und leeren Bit-Arrays. Für die meisten Anwendungen ist es entscheidend, ob ein Bit-Array Daten enthält oder nicht, und dies lässt sich mit ` isEmpty()` feststellen.

Siehe auch ` isEmpty()`.

void QBitArray::resize(qsizetype size)

Passen Sie die Größe des Bit-Arrays auf size Bits an.

Ist ` size ` größer als die aktuelle Größe, wird das Bit-Array auf ` size ` Bits erweitert, wobei die zusätzlichen Bits am Ende angehängt werden. Die neuen Bits werden auf „false“ (0) initialisiert.

Ist ` size ` kleiner als die aktuelle Größe, werden Bits am Ende entfernt.

Siehe auch size().

void QBitArray::setBit(qsizetype i)

Setzt das Bit an der Indexposition i auf 1.

i muss eine gültige Indexposition im Bit-Array sein (d. h. 0 <= i < size()).

Siehe auch clearBit() und toggleBit().

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

Setzt das Bit an der Indexposition „ i “ auf „ value “.

qsizetype QBitArray::size() const

Gibt die Anzahl der im Bit-Array gespeicherten Bits zurück.

Siehe auch ` resize()`.

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

Tauscht dieses Bit-Array mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

bool QBitArray::testBit(qsizetype i) const

Gibt „ true “ zurück, wenn das Bit an der Indexposition „ i “ den Wert 1 hat; andernfalls wird „ false “ zurückgegeben.

i muss eine gültige Indexposition im Bit-Array sein (d. h., 0 <= i < size()).

Siehe auch setBit() und clearBit().

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

Gibt das Array der in einen int konvertierten Bits zurück. Die Konvertierung basiert auf endianness. Konvertiert bis zu den ersten 32 Bits des Arrays in quint32 und gibt diese unter Beachtung von endianness zurück. Wenn ok kein Nullzeiger ist und das Array mehr als 32 Bits hat, wird ok auf false gesetzt und diese Funktion gibt Null zurück; andernfalls wird es auf true gesetzt.

Diese Funktion wurde in Qt 6.0 eingeführt.

bool QBitArray::toggleBit(qsizetype i)

Kehrt den Wert des Bits an der Indexposition i um und gibt den vorherigen Wert dieses Bits entweder als „true“ (falls es gesetzt war) oder als „false“ (falls es nicht gesetzt war) zurück.

War der vorherige Wert 0, ist der neue Wert 1. War der vorherige Wert 1, ist der neue Wert 0.

i muss eine gültige Indexposition im Bit-Array sein (d. h. 0 <= i < size()).

Siehe auch setBit() und clearBit().

void QBitArray::truncate(qsizetype pos)

Kürzt das Bit-Array an der Indexposition pos ab.

Liegt pos außerhalb des Array-Endes, geschieht nichts.

Siehe auch resize().

Führt die UND-Operation zwischen allen Bits in diesem Bit-Array und other durch. Weist das Ergebnis diesem Bit-Array zu und gibt eine Referenz darauf zurück.

Das Ergebnis hat die Länge des längeren der beiden Bit-Arrays, wobei fehlende Bits (falls ein Array kürzer als das andere ist) mit 0 gesetzt werden.

Beispiel:

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 ]

Siehe auch operator&(), operator|=(), operator^=() und operator~().

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

Verschiebt „ other “ in dieses Bit-Array und gibt eine Referenz auf dieses Bit-Array zurück.

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

Weist diesem Bit-Array den Wert „ other “ zu und gibt eine Referenz auf dieses Bit-Array zurück.

QBitRef QBitArray::operator[](qsizetype i)

Gibt das Bit an der Indexposition i als bearbeitbare Referenz zurück.

i muss eine gültige Indexposition im Bit-Array sein (d. h. 0 <= i < size()).

Beispiel:

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

Der Rückgabewert ist vom Typ `QBitRef`, einer Hilfsklasse für ` QBitArray`. Wenn Sie ein Objekt vom Typ `QBitRef` erhalten, können Sie ihm einen Wert zuweisen, und die Zuweisung wirkt sich auf das Bit im ` QBitArray ` aus, von dem Sie die Referenz erhalten haben.

Die Funktionen „ testBit()“, „ setBit()“ und „ clearBit()“ sind etwas schneller.

Siehe auch at(), testBit(), setBit() und clearBit().

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

Führt die XOR-Operation zwischen allen Bits in diesem Bit-Array und other durch. Weist das Ergebnis diesem Bit-Array zu und gibt eine Referenz darauf zurück.

Das Ergebnis hat die Länge des längeren der beiden Bit-Arrays, wobei fehlende Bits (falls ein Array kürzer als das andere ist) mit 0 gesetzt werden.

Beispiel:

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 ]

Siehe auch operator^(), operator&=(), operator|=() und operator~().

Führt die OR-Operation zwischen allen Bits in diesem Bit-Array und other durch. Weist das Ergebnis diesem Bit-Array zu und gibt eine Referenz darauf zurück.

Das Ergebnis hat die Länge des längeren der beiden Bit-Arrays, wobei fehlende Bits (falls ein Array kürzer als das andere ist) mit 0 gesetzt werden.

Beispiel:

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 ]

Siehe auch „ operator|()“, „ operator&=()“, „ operator^=()“ und „ operator~()“.