QList Class

Dokumentation der Mitgliedsfunktionen

Setzt die Größe der Liste auf size. Ist size größer als die aktuelle Größe, werden Elemente am Ende hinzugefügt; die neuen Elemente werden entweder mit einem standardmäßig erstellten Wert oder mit c initialisiert. Ist size kleiner als die aktuelle Größe, werden Elemente am Ende entfernt.

Wenn diese Liste nicht gemeinsam genutzt wird, bleibt capacity() erhalten. Verwenden Sie squeeze(), um überschüssige Kapazität abzubauen.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch size().

Fügt value am Anfang der Liste ein.

Beispiel:

QList<QString> list;
list.prepend("one");
list.prepend("two");
list.prepend("three");
// list: ["three", "two", "one"]

Dies ist dasselbe wie list.insert(0, value).

Normalerweise ist diese Operation relativ schnell (amortisierte konstante Zeit). QList ist in der Lage, zusätzlichen Speicher am Anfang der Listendaten zuzuweisen und in diese Richtung zu wachsen, ohne die Daten bei jeder Operation neu zuzuweisen oder zu verschieben. Wenn Sie jedoch eine Containerklasse mit einer Garantie für konstante Zeit verwenden möchten, sollten Sie stattdessen std::list verwenden, ansonsten aber QList bevorzugen.

Siehe auch append() und insert().

Fügt ein neues Element am Ende des Containers hinzu. Dieses neue Element wird an Ort und Stelle konstruiert, wobei args als Argumente für seine Konstruktion verwendet werden.

Gibt einen Verweis auf das neue Element zurück.

Beispiel:

QList<QString> list{"eins", "zwei"}; list.emplaceBack(3, 'a');qDebug() << list;
// Liste: ["eins", "zwei", "aaa"]

Es ist auch möglich, auf ein neu erstelltes Objekt über eine zurückgegebene Referenz zuzugreifen:

QList<QString> list;
auto &ref = list.emplaceBack();
ref = "one";
// list: ["one"]

Dies ist dasselbe wie list.emplace(list.size(), args).

Siehe auch emplace.

Fügt value an der Indexposition i in die Liste ein. Wenn i gleich 0 ist, wird der Wert der Liste vorangestellt. Wenn i gleich size() ist, wird der Wert an die Liste angehängt.

Beispiel:

QList<QString> list = {"alpha", "beta", "delta"};
list.insert(2, "gamma");
// list: ["alpha", "beta", "gamma", "delta"]

Bei großen Listen kann dieser Vorgang langsam sein(lineare Zeit), da er erfordert, dass alle Elemente mit den Indizes i und darüber um eine Position weiter in den Speicher verschoben werden. Wenn Sie eine Containerklasse wünschen, die eine schnelle insert()-Funktion bietet, verwenden Sie stattdessen std::list.

Siehe auch append(), prepend(), und remove().

Dies ist eine überladene Funktion.

Fügt value vor dem Element ein, auf das der Iterator before zeigt. Gibt einen Iterator zurück, der auf das eingefügte Element zeigt.

Ersetzt das Element an der Indexposition i durch value.

i muss eine gültige Indexposition in der Liste sein (d.h. 0 <= i < size()).

Siehe auch operator[]() und remove().

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu prepend(value).

Sie gibt die maximale Anzahl von Elementen zurück, die die Liste theoretisch enthalten kann. In der Praxis kann die Anzahl viel kleiner sein, begrenzt durch den dem System zur Verfügung stehenden Speicher.

Diese Funktion wurde in Qt 6.8 eingeführt.

Gibt eine Liste zurück, die alle Elemente in dieser Liste enthält, gefolgt von allen Elementen in der Liste other.

Siehe auch operator+=().

QList::QList()

Konstruiert eine leere Liste.

Siehe auch resize().

[explicit] QList::QList(qsizetype size)

Konstruiert eine Liste mit einer Anfangsgröße von size Elementen.

Die Elemente werden mit einem standardmäßig konstruierten Wert initialisiert.

Siehe auch resize().

QList::QList(std::initializer_list<T> args)

Konstruiert eine Liste aus der std::initializer_list, die durch args gegeben ist.

template <typename InputIterator, QList<T>::if_input_iterator<InputIterator> = true> QList::QList(InputIterator first, InputIterator last)

Konstruiert eine Liste mit dem Inhalt im Iteratorbereich [first, last).

Der Wertetyp von InputIterator muss nach T konvertierbar sein.

QList::QList(qsizetype size, QList<T>::parameter_type value)

Konstruiert eine Liste mit einer Anfangsgröße von size Elementen. Jedes Element wird mit value initialisiert.

Siehe auch resize() und fill().

[since 6.8] QList::QList(qsizetype size, Qt::Initialization)

Konstruiert eine Liste mit einer Anfangsgröße von size Elementen.

QList wird versuchen, die Elemente nicht zu initialisieren.

Genauer gesagt:

• Wenn T einen Konstruktor hat, der Qt::Uninitialized akzeptiert, wird dieser Konstruktor verwendet, um die Elemente zu initialisieren;
• Andernfalls wird jedes Element standardmäßig konstruiert. Für trivial konstruierbare Typen (wie int, float, etc.) ist dies gleichbedeutend damit, sie nicht zu initialisieren.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch resizeForOverwrite().

[default] QList::QList(const QList<T> &other)

Konstruiert eine Kopie von other.

Dieser Vorgang benötigt konstante Zeit, da QList implizit gemeinsam genutzt wird. Das macht die Rückgabe einer QList aus einer Funktion sehr schnell. Wenn eine gemeinsam genutzte Instanz geändert wird, wird sie kopiert (copy-on-write), was lineare Zeit benötigt.

Siehe auch operator=().

[default] QList::QList(QList<T> &&other)

Move-konstruiert eine QList-Instanz, die auf das gleiche Objekt zeigt, auf das other gezeigt hat.

[default] QList::~QList()

Zerstört die Liste.

void QList::append(QList<T>::parameter_type value)

Fügt value am Ende der Liste ein.

Beispiel:

QList<QString> list;
list.append("one");
list.append("two");
QString three = "three";
list.append(three);
// list: ["one", "two", "three"]
// three: "three"

Dies ist dasselbe wie der Aufruf von resize(size() + 1) und die Zuweisung von value an das neue letzte Element der Liste.

Dieser Vorgang ist relativ schnell, da QList normalerweise mehr Speicher als nötig zuweist, so dass die Liste wachsen kann, ohne jedes Mal die gesamte Liste neu zuzuweisen.

Siehe auch operator<<(), prepend(), und insert().

[since 6.0] void QList::append(QList<T> &&value)

Dies ist eine überladene Funktion.

Verschiebt die Elemente der Liste value an das Ende dieser Liste.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch operator<<() und operator+=().

void QList::append(QList<T>::rvalue_ref value)

Dies ist eine überladene Funktion.

Beispiel:

QList<QString> list;
list.append("one");
list.append("two");
QString three = "three";
list.append(std::move(three));
// list: ["one", "two", "three"]
// three: ""

void QList::append(const QList<T> &value)

Dies ist eine überladene Funktion.

Hängt die Elemente der Liste value an diese Liste an.

Siehe auch operator<<() und operator+=().

[since 6.6] QList<T> &QList::assign(std::initializer_list<T> l)

Ersetzt den Inhalt dieser Liste durch eine Kopie der Elemente von l.

Die Größe dieser Liste ist gleich der Anzahl der Elemente in l.

Diese Funktion weist nur dann Speicher zu, wenn die Anzahl der Elemente in l die Kapazität dieser Liste übersteigt oder diese Liste gemeinsam genutzt wird.

Diese Funktion wurde in Qt 6.6 eingeführt.

[since 6.6] template <typename InputIterator, QList<T>::if_input_iterator<InputIterator> = true> QList<T> &QList::assign(InputIterator first, InputIterator last)

Ersetzt den Inhalt dieser Liste durch eine Kopie der Elemente im Iteratorbereich [first, last).

Die Größe dieser Liste ist gleich der Anzahl der Elemente im Bereich [first, last).

Diese Funktion wird nur dann Speicher zuweisen, wenn die Anzahl der Elemente im Bereich die Kapazität dieser Liste übersteigt oder diese Liste gemeinsam genutzt wird.

Diese Funktion wurde in Qt 6.6 eingeführt.

[since 6.6] QList<T> &QList::assign(qsizetype n, QList<T>::parameter_type t)

Ersetzt den Inhalt dieser Liste durch n Kopien von t.

Die Größe dieser Liste ist gleich n.

Diese Funktion weist nur dann Speicher zu, wenn n die Kapazität der Liste überschreitet oder diese Liste gemeinsam genutzt wird.

Diese Funktion wurde in Qt 6.6 eingeführt.

[noexcept] QList<T>::const_reference QList::at(qsizetype i) const

Gibt das Element an der Indexposition i in der Liste zurück.

i muss eine gültige Indexposition in der Liste sein (d.h. 0 <= i < size()).

Siehe auch value() und operator[]().

QList<T>::reference QList::back()

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu last().

[noexcept] QList<T>::const_reference QList::back() const

Dies ist eine überladene Funktion.

QList<T>::iterator QList::begin()

Gibt einen Iterator im STL-Stil zurück, der auf das erste Element in der Liste zeigt.

Siehe auch constBegin() und end().

[noexcept] QList<T>::const_iterator QList::begin() const

Dies ist eine überladene Funktion.

qsizetype QList::capacity() const

Gibt die maximale Anzahl von Elementen zurück, die in der Liste gespeichert werden können, ohne eine Neuzuweisung zu erzwingen.

Der einzige Zweck dieser Funktion ist es, eine Feinabstimmung der Speichernutzung von QList zu ermöglichen. Im Allgemeinen werden Sie diese Funktion nur selten aufrufen müssen. Wenn Sie wissen wollen, wie viele Einträge in der Liste sind, rufen Sie size() auf.

Siehe auch reserve() und squeeze().

[noexcept] QList<T>::const_iterator QList::cbegin() const

Gibt einen Iterator im Stil von const STL zurück, der auf das erste Element in der Liste zeigt.

Siehe auch begin() und cend().

[noexcept] QList<T>::const_iterator QList::cend() const

Gibt einen const STL-artigen Iterator zurück, der direkt auf das letzte Element in der Liste zeigt.

Siehe auch cbegin() und end().

void QList::clear()

Entfernt alle Elemente aus der Liste.

Wenn diese Liste nicht gemeinsam genutzt wird, bleibt capacity() erhalten. Verwenden Sie squeeze(), um überschüssige Kapazität abzubauen.

Siehe auch resize() und squeeze().

[noexcept] QList<T>::const_iterator QList::constBegin() const

Gibt einen Iterator im Stil von const STL zurück, der auf das erste Element in der Liste zeigt.

Siehe auch begin() und constEnd().

[noexcept] QList<T>::const_pointer QList::constData() const

Gibt einen konstanten Zeiger auf die in der Liste gespeicherten Daten zurück. Der Zeiger kann für den Zugriff auf die Elemente in der Liste verwendet werden.

Diese Funktion ist vor allem nützlich, um eine Liste an eine Funktion zu übergeben, die ein einfaches C++-Array akzeptiert.

Siehe auch data() und operator[]().

[noexcept] QList<T>::const_iterator QList::constEnd() const

Gibt einen const STL-artigen Iterator zurück, der direkt auf das letzte Element in der Liste zeigt.

Siehe auch constBegin() und end().

[noexcept] const T &QList::constFirst() const

Gibt einen konstanten Verweis auf den ersten Eintrag in der Liste zurück. Diese Funktion geht davon aus, dass die Liste nicht leer ist.

Siehe auch constLast(), isEmpty(), und first().

[noexcept] const T &QList::constLast() const

Gibt einen konstanten Verweis auf den letzten Eintrag in der Liste zurück. Diese Funktion geht davon aus, dass die Liste nicht leer ist.

Siehe auch constFirst(), isEmpty(), und last().

[noexcept] template <typename AT> bool QList::contains(const AT &value) const

Gibt true zurück, wenn die Liste ein Vorkommen von value enthält; andernfalls wird false zurückgegeben.

Diese Funktion setzt voraus, dass der Wertetyp eine Implementierung von operator==() hat.

Siehe auch indexOf() und count().

[noexcept] template <typename AT = T> qsizetype QList::count(const AT &value) const

Gibt die Anzahl der Vorkommen von value in der Liste zurück.

Diese Funktion setzt voraus, dass der Wertetyp eine Implementierung von operator==() hat.

Siehe auch contains() und indexOf().

[noexcept] qsizetype QList::count() const

Dies ist eine überladene Funktion.

Dasselbe wie size().

[noexcept] QList<T>::const_reverse_iterator QList::crbegin() const

Gibt einen Reverse-Iterator im Stil von const STL zurück, der auf das erste Element der Liste in umgekehrter Reihenfolge zeigt.

Siehe auch begin(), rbegin(), und rend().

[noexcept] QList<T>::const_reverse_iterator QList::crend() const

Gibt einen umgekehrten Iterator im Stil von const STL zurück, der in umgekehrter Reihenfolge direkt auf das letzte Element in der Liste zeigt.

Siehe auch end(), rend(), und rbegin().

QList<T>::pointer QList::data()

Gibt einen Zeiger auf die in der Liste gespeicherten Daten zurück. Der Zeiger kann für den Zugriff auf die Elemente in der Liste und für deren Änderung verwendet werden.

Beispiel:

QList<int> list(10);
int *data = list.data();
for (qsizetype i = 0; i < 10; ++i)
    data[i] = 2 * i;

Diese Funktion ist vor allem nützlich, um eine Liste an eine Funktion zu übergeben, die ein einfaches C++-Array akzeptiert.

Siehe auch constData() und operator[]().

[noexcept] QList<T>::const_pointer QList::data() const

Dies ist eine überladene Funktion.

template <typename... Args> QList<T>::iterator QList::emplace(qsizetype i, Args &&... args)

Erweitert den Container durch Einfügen eines neuen Elements an der Position i. Dieses neue Element wird an Ort und Stelle konstruiert, wobei args als Argumente für seine Konstruktion verwendet werden.

Gibt einen Iterator zum neuen Element zurück.

Beispiel:

QList<QString> list{"a", "ccc"};
list.emplace(1, 2, 'b');
// list: ["a", "bb", "ccc"]

Siehe auch emplaceBack.

template <typename... Args> QList<T>::iterator QList::emplace(QList<T>::const_iterator before, Args &&... args)

Dies ist eine überladene Funktion.

Erzeugt ein neues Element vor dem Element, auf das der Iterator before zeigt. Dieses neue Element wird an Ort und Stelle konstruiert, wobei args als Argumente für seine Konstruktion verwendet werden.

Gibt einen Iterator zum neuen Element zurück.

[noexcept] bool QList::empty() const

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu isEmpty() und gibt true zurück, wenn die Liste leer ist; andernfalls gibt sie false zurück.

QList<T>::iterator QList::end()

Gibt einen Iterator im STL-Stil zurück, der direkt auf das letzte Element in der Liste zeigt.

Siehe auch begin() und constEnd().

[noexcept] QList<T>::const_iterator QList::end() const

Dies ist eine überladene Funktion.

bool QList::endsWith(QList<T>::parameter_type value) const

Gibt true zurück, wenn diese Liste nicht leer ist und ihr letzter Eintrag gleich value ist; andernfalls wird false zurückgegeben.

Siehe auch isEmpty() und last().

QList<T>::iterator QList::erase(QList<T>::const_iterator pos)

Entfernt das Element, auf das der Iterator pos zeigt, aus der Liste und gibt einen Iterator zum nächsten Element in der Liste zurück (der end() sein kann).

Durch das Entfernen von Elementen wird die Kapazität der Liste erhalten und der zugewiesene Speicherplatz nicht verringert. Um zusätzliche Kapazität abzubauen und so viel Speicher wie möglich freizugeben, rufen Sie squeeze() auf.

Siehe auch insert() und remove().

QList<T>::iterator QList::erase(QList<T>::const_iterator begin, QList<T>::const_iterator end)

Dies ist eine überladene Funktion.

Entfernt alle Elemente von begin bis zu (aber nicht einschließlich) end. Gibt einen Iterator zu demselben Element zurück, auf das end vor dem Aufruf verwiesen hat.

Durch das Entfernen von Elementen wird die Kapazität der Liste erhalten und der zugewiesene Speicher nicht verringert. Um zusätzliche Kapazität abzubauen und so viel Speicher wie möglich freizugeben, rufen Sie squeeze() auf.

QList<T> &QList::fill(QList<T>::parameter_type value, qsizetype size = -1)

Weist allen Elementen in der Liste value zu. Wenn size ungleich -1 ist (die Vorgabe), wird die Liste vorher auf size angepasst.

Beispiel:

QList<QString> list(3);
list.fill("Yes");
// list: ["Yes", "Yes", "Yes"]

list.fill("oh", 5);
// list: ["oh", "oh", "oh", "oh", "oh"]

Siehe auch resize().

T &QList::first()

Gibt einen Verweis auf den ersten Eintrag in der Liste zurück. Diese Funktion geht davon aus, dass die Liste nicht leer ist.

Siehe auch last(), isEmpty(), und constFirst().

[since 6.0] QList<T> QList::first(qsizetype n) const

Gibt eine Teilliste zurück, die die ersten n Elemente dieser Liste enthält.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch last() und sliced().

[noexcept] const T &QList::first() const

Dies ist eine überladene Funktion.

QList<T>::reference QList::front()

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu first().

[noexcept] QList<T>::const_reference QList::front() const

Dies ist eine überladene Funktion.

[noexcept] template <typename AT> qsizetype QList::indexOf(const AT &value, qsizetype from = 0) const

Gibt die Indexposition des ersten Vorkommens von value in der Liste zurück, wobei ab der Indexposition from vorwärts gesucht wird. Gibt -1 zurück, wenn kein Element übereinstimmt.

Beispiel:

QList<QString> list{"A", "B", "C", "B", "A"};
list.indexOf("B");            // returns 1
list.indexOf("B", 1);         // returns 1
list.indexOf("B", 2);         // returns 3
list.indexOf("X");            // returns -1

Für diese Funktion muss der Wertetyp eine Implementierung von operator==() haben.

Siehe auch lastIndexOf() und contains().

QList<T>::iterator QList::insert(QList<T>::const_iterator before, qsizetype count, QList<T>::parameter_type value)

Fügt count Kopien von value vor dem Element ein, auf das der Iterator before zeigt. Gibt einen Iterator zurück, der auf das erste der eingefügten Elemente zeigt.

QList<T>::iterator QList::insert(qsizetype i, qsizetype count, QList<T>::parameter_type value)

Dies ist eine überladene Funktion.

Fügt count Kopien von value an der Indexposition i in die Liste ein.

Beispiel:

QList<double> list = {2.718, 1.442, 0.4342};
list.insert(1, 3, 9.9);
// list: [2.718, 9.9, 9.9, 9.9, 1.442, 0.4342]

[noexcept] bool QList::isEmpty() const

Gibt true zurück, wenn die Liste die Größe 0 hat; andernfalls wird false zurückgegeben.

Siehe auch size() und resize().

T &QList::last()

Gibt einen Verweis auf den letzten Eintrag in der Liste zurück. Diese Funktion geht davon aus, dass die Liste nicht leer ist.

Siehe auch first(), isEmpty(), und constLast().

[since 6.0] QList<T> QList::last(qsizetype n) const

Gibt eine Teilliste zurück, die die letzten n Elemente dieser Liste enthält.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch first() und sliced().

[noexcept] const T &QList::last() const

Dies ist eine überladene Funktion.

[noexcept] template <typename AT> qsizetype QList::lastIndexOf(const AT &value, qsizetype from = -1) const

Gibt die Indexposition des letzten Vorkommens des Wertes value in der Liste zurück, wobei ab der Indexposition from rückwärts gesucht wird. Ist from gleich -1 (Standardwert), beginnt die Suche beim letzten Element. Gibt -1 zurück, wenn kein Element übereinstimmt.

Beispiel:

QList<QString> list = {"A", "B", "C", "B", "A"};
list.lastIndexOf("B");        // returns 3
list.lastIndexOf("B", 3);     // returns 3
list.lastIndexOf("B", 2);     // returns 1
list.lastIndexOf("X");        // returns -1

Diese Funktion erfordert, dass der Wertetyp eine Implementierung von operator==() hat.

Siehe auch indexOf().

[noexcept] qsizetype QList::length() const

Dasselbe wie size() und count().

Siehe auch size() und count().

QList<T> QList::mid(qsizetype pos, qsizetype length = -1) const

Gibt eine Teilliste zurück, die Elemente aus dieser Liste enthält, beginnend an der Position pos. Ist length gleich -1 (Standardeinstellung), werden alle Elemente nach pos einbezogen; andernfalls werden length Elemente (oder alle verbleibenden Elemente, wenn es weniger als length Elemente gibt) einbezogen.

void QList::move(qsizetype from, qsizetype to)

Verschiebt das Element an der Indexposition from an die Indexposition to.

[noexcept] void QList::pop_back()

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu removeLast().

[noexcept] void QList::pop_front()

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu removeFirst().

void QList::push_back(QList<T>::parameter_type value)

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu append(value).

void QList::push_back(QList<T>::rvalue_ref value)

Dies ist eine überladene Funktion.

QList<T>::reverse_iterator QList::rbegin()

Gibt einen umgekehrten Iterator im STL-Stil zurück, der auf das erste Element in der Liste in umgekehrter Reihenfolge zeigt.

Siehe auch begin(), crbegin(), und rend().

[noexcept] QList<T>::const_reverse_iterator QList::rbegin() const

Dies ist eine überladene Funktion.

void QList::remove(qsizetype i, qsizetype n = 1)

Entfernt n Elemente aus der Liste, beginnend mit der Indexposition i.

Durch das Entfernen von Elementen bleibt die Kapazität der Liste erhalten und der zugewiesene Speicherplatz wird nicht verringert. Um zusätzliche Kapazität abzubauen und so viel Speicher wie möglich freizugeben, rufen Sie squeeze() auf.

Siehe auch insert(), replace(), und fill().

template <typename AT = T> qsizetype QList::removeAll(const AT &t)

Entfernt alle Elemente, die gleich t sind, aus der Liste. Gibt die Anzahl der entfernten Elemente zurück, falls vorhanden.

Das Entfernen von Elementen erhält die Kapazität der Liste und verringert nicht die Menge des zugewiesenen Speichers. Um zusätzliche Kapazität abzubauen und so viel Speicher wie möglich freizugeben, rufen Sie squeeze() auf.

Siehe auch removeOne().

void QList::removeAt(qsizetype i)

Entfernt das Element an der Indexposition i. Äquivalent zu

remove(i);

Das Entfernen von Elementen erhält die Kapazität der Liste und verringert nicht die Menge des zugewiesenen Speichers. Um zusätzliche Kapazität abzubauen und so viel Speicher wie möglich freizugeben, rufen Sie squeeze() auf.

Siehe auch remove().

[noexcept] void QList::removeFirst()

Entfernt den ersten Eintrag in der Liste. Der Aufruf dieser Funktion ist gleichbedeutend mit dem Aufruf von remove(0). Die Liste darf nicht leer sein. Wenn die Liste leer sein kann, rufen Sie isEmpty() auf, bevor Sie diese Funktion aufrufen.

Das Entfernen von Elementen erhält die Kapazität der Liste und verringert nicht den zugewiesenen Speicherplatz. Um zusätzliche Kapazität abzubauen und so viel Speicher wie möglich freizugeben, rufen Sie squeeze() auf.

Siehe auch remove(), takeFirst(), und isEmpty().

[since 6.1] template <typename Predicate> qsizetype QList::removeIf(Predicate pred)

Entfernt alle Elemente, für die das Prädikat pred den Wert true liefert, aus der Liste. Gibt die Anzahl der entfernten Elemente zurück, falls vorhanden.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch removeAll().

[noexcept] void QList::removeLast()

Entfernt das letzte Element in der Liste. Der Aufruf dieser Funktion ist gleichbedeutend mit dem Aufruf von remove(size() - 1). Die Liste darf nicht leer sein. Wenn die Liste leer sein kann, rufen Sie isEmpty() auf, bevor Sie diese Funktion aufrufen.

Durch das Entfernen von Elementen bleibt die Kapazität der Liste erhalten und der zugewiesene Speicherplatz wird nicht verringert. Um zusätzliche Kapazität abzubauen und so viel Speicher wie möglich freizugeben, rufen Sie squeeze() auf.

Siehe auch remove(), takeLast(), removeFirst(), und isEmpty().

template <typename AT = T> bool QList::removeOne(const AT &t)

Entfernt das erste Element, das gleich t ist, aus der Liste. Gibt zurück, ob ein Element tatsächlich entfernt wurde.

Durch das Entfernen von Elementen wird die Kapazität der Liste erhalten und der zugewiesene Speicherplatz nicht verringert. Um zusätzliche Kapazität abzubauen und so viel Speicher wie möglich freizugeben, rufen Sie squeeze() auf.

Siehe auch removeAll().

QList<T>::reverse_iterator QList::rend()

Gibt einen umgekehrten Iterator im STL-Stil zurück, der in umgekehrter Reihenfolge direkt auf das letzte Element in der Liste zeigt.

Siehe auch end(), crend(), und rbegin().

[noexcept] QList<T>::const_reverse_iterator QList::rend() const

Dies ist eine überladene Funktion.

void QList::reserve(qsizetype size)

Versucht, Speicher für mindestens size Elemente zuzuweisen.

Wenn Sie im Voraus wissen, wie groß die Liste sein wird, sollten Sie diese Funktion aufrufen, um Neuzuweisungen und Speicherfragmentierung zu vermeiden. Wenn Sie die Größe der Liste häufig ändern, werden Sie wahrscheinlich auch eine bessere Leistung erzielen.

Wenn Sie sich nicht sicher sind, wie viel Speicherplatz benötigt wird, ist es in der Regel besser, eine Obergrenze wie size zu verwenden, oder eine hohe Schätzung der wahrscheinlichsten Größe, wenn eine strenge Obergrenze viel größer wäre als diese. Wenn size eine zu niedrige Schätzung ist, wird die Liste nach Bedarf wachsen, sobald die reservierte Größe überschritten wird, was zu einer größeren Zuweisung führen kann, als es Ihre beste Überschätzung getan hätte, und die Operation, die sie auslöst, verlangsamen wird.

Siehe auch squeeze(), capacity(), und resize().

[since 6.8] void QList::resizeForOverwrite(qsizetype size)

Setzt die Größe der Liste auf size. Wenn size kleiner als die aktuelle Größe ist, werden Elemente vom Ende entfernt. Ist size größer als die aktuelle Größe, werden Elemente am Ende hinzugefügt; QList wird versuchen, diese neuen Elemente nicht zu initialisieren.

Konkret bedeutet dies:

• Wenn T einen Konstruktor hat, der Qt::Uninitialized akzeptiert, wird dieser Konstruktor verwendet, um die Elemente zu initialisieren;
• Andernfalls wird jedes Element standardmäßig konstruiert. Für trivial konstruierbare Typen (wie int, float, etc.) ist dies gleichbedeutend damit, sie nicht zu initialisieren.

Diese Funktion wurde in Qt 6.8 eingeführt.

void QList::shrink_to_fit()

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu squeeze().

[noexcept] qsizetype QList::size() const

Gibt die Anzahl der Elemente in der Liste zurück.

Siehe auch isEmpty() und resize().

[since 6.0] QList<T> QList::sliced(qsizetype pos, qsizetype n) const

Gibt eine Teilliste zurück, die n Elemente dieser Liste enthält, beginnend an der Position pos.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch first() und last().

[since 6.0] QList<T> QList::sliced(qsizetype pos) const

Dies ist eine überladene Funktion.

Gibt eine Teilliste zurück, die die Elemente dieser Liste ab der Position pos bis zu ihrem Ende enthält.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch first() und last().

void QList::squeeze()

Gibt den Speicher frei, der für die Speicherung der Elemente nicht benötigt wird.

Der einzige Zweck dieser Funktion ist es, eine Feinabstimmung der Speichernutzung von QList zu ermöglichen. Im Allgemeinen werden Sie diese Funktion nur selten aufrufen müssen.

Siehe auch reserve() und capacity().

bool QList::startsWith(QList<T>::parameter_type value) const

Gibt true zurück, wenn diese Liste nicht leer ist und ihr erstes Element gleich value ist; andernfalls wird false zurückgegeben.

Siehe auch isEmpty() und first().

[noexcept] void QList::swap(QList<T> &other)

Tauscht diese Liste mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

void QList::swapItemsAt(qsizetype i, qsizetype j)

Tausche das Element an der Indexposition i gegen das Element an der Indexposition j aus. Diese Funktion geht davon aus, dass sowohl i als auch j mindestens 0 aber kleiner als size() sind. Um einen Fehler zu vermeiden, prüfen Sie, ob sowohl i als auch j mindestens 0 und kleiner als size() sind.

T QList::takeAt(qsizetype i)

Entfernt das Element an der Indexposition i und gibt es zurück.

Äquivalent zu

T t = at(i);
remove(i);
return t;

Siehe auch takeFirst() und takeLast().

QList<T>::value_type QList::takeFirst()

Entfernt das erste Element der Liste und gibt es zurück. Diese Funktion setzt voraus, dass die Liste nicht leer ist. Um Fehlschläge zu vermeiden, rufen Sie isEmpty() auf, bevor Sie diese Funktion aufrufen.

Siehe auch takeLast() und removeFirst().

QList<T>::value_type QList::takeLast()

Entfernt das letzte Element in der Liste und gibt es zurück. Diese Funktion setzt voraus, dass die Liste nicht leer ist. Um Fehlschläge zu vermeiden, rufen Sie isEmpty() auf, bevor Sie diese Funktion aufrufen.

Wenn Sie den Rückgabewert nicht verwenden, ist removeLast() effizienter.

Siehe auch takeFirst() und removeLast().

T QList::value(qsizetype i) const

Gibt den Wert an der Indexposition i in der Liste zurück.

Wenn der Index i außerhalb des zulässigen Bereichs liegt, gibt die Funktion einen standardmäßig konstruierten Wert zurück. Wenn Sie sicher sind, dass i innerhalb der Grenzen liegt, können Sie stattdessen at() verwenden, was etwas schneller ist.

Siehe auch at() und operator[]().

T QList::value(qsizetype i, QList<T>::parameter_type defaultValue) const

Dies ist eine überladene Funktion.

Wenn der Index i außerhalb der Grenzen liegt, gibt die Funktion defaultValue zurück.

bool QList::operator!=(const QList<T> &other) const

Gibt true zurück, wenn other nicht gleich dieser Liste ist; andernfalls wird false zurückgegeben.

Zwei Listen werden als gleich angesehen, wenn sie die gleichen Werte in der gleichen Reihenfolge enthalten.

Diese Funktion setzt voraus, dass der Wertetyp eine Implementierung von operator==() hat.

Siehe auch operator==().

QList<T> &QList::operator+=(const QList<T> &other)

Hängt die Elemente der Liste other an diese Liste an und gibt einen Verweis auf diese Liste zurück.

Siehe auch operator+() und append().

[since 6.0] QList<T> &QList::operator+=(QList<T> &&other)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch operator+() und append().

QList<T> &QList::operator+=(QList<T>::parameter_type value)

Dies ist eine überladene Funktion.

Hängt value an die Liste an.

Siehe auch append() und operator<<().

QList<T> &QList::operator+=(QList<T>::rvalue_ref value)

Dies ist eine überladene Funktion.

Siehe auch append() und operator<<().

bool QList::operator<(const QList<T> &other) const

Gibt true zurück, wenn diese Liste lexikalisch kleiner als other ist; andernfalls wird false zurückgegeben.

Diese Funktion setzt voraus, dass der Wertetyp eine Implementierung von operator<() hat.

QList<T> &QList::operator<<(QList<T>::parameter_type value)

Hängt value an die Liste an und gibt einen Verweis auf diese Liste zurück.

Siehe auch append() und operator+=().

QList<T> &QList::operator<<(const QList<T> &other)

Hängt other an die Liste an und gibt einen Verweis auf die Liste zurück.

[since 6.0] QList<T> &QList::operator<<(QList<T> &&other)

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.0 eingeführt.

QList<T> &QList::operator<<(QList<T>::rvalue_ref value)

Dies ist eine überladene Funktion.

Siehe auch append() und operator+=().

bool QList::operator<=(const QList<T> &other) const

Gibt true zurück, wenn diese Liste lexikalisch kleiner oder gleich other ist; andernfalls wird false zurückgegeben.

Diese Funktion setzt voraus, dass der Wertetyp eine Implementierung von operator<() hat.

[default] QList<T> &QList::operator=(QList<T> &&other)

Verschieben - weist other dieser QList Instanz zu.

[default] QList<T> &QList::operator=(const QList<T> &other)

Weist other dieser Liste zu und gibt einen Verweis auf diese Liste zurück.

QList<T> &QList::operator=(std::initializer_list<T> args)

Weist die Sammlung von Werten in args dieser QList Instanz zu.

bool QList::operator==(const QList<T> &other) const

Gibt true zurück, wenn other mit dieser Liste übereinstimmt; andernfalls wird false zurückgegeben.

Zwei Listen werden als gleich angesehen, wenn sie die gleichen Werte in der gleichen Reihenfolge enthalten.

Diese Funktion setzt voraus, dass der Wertetyp eine Implementierung von operator==() hat.

Siehe auch operator!=().

bool QList::operator>(const QList<T> &other) const

Gibt true zurück, wenn diese Liste lexikalisch größer als other ist; andernfalls wird false zurückgegeben.

Diese Funktion setzt voraus, dass der Wertetyp eine Implementierung von operator<() hat.

bool QList::operator>=(const QList<T> &other) const

Gibt true zurück, wenn diese Liste lexikalisch größer oder gleich other ist; andernfalls wird false zurückgegeben.

Für diese Funktion muss der Wertetyp eine Implementierung von operator<() haben.

QList<T>::reference QList::operator[](qsizetype i)

Gibt das Element an der Indexposition i als änderbare Referenz zurück.

i muss eine gültige Indexposition in der Liste sein (d.h. 0 <= i < size()).

Beachten Sie, dass die Verwendung von Nicht-Konst-Operatoren dazu führen kann, dass QList eine Deep Copy durchführt.

Siehe auch at() und value().

[noexcept] QList<T>::const_reference QList::operator[](qsizetype i) const

Dies ist eine überladene Funktion.

Dasselbe wie at(i).