QList Class

Documentation sur les fonctions membres

[constexpr noexcept] QList::QList()

Construit une liste vide.

Voir aussi resize().

[explicit] QList::QList(qsizetype size)

Construit une liste avec une taille initiale de size éléments.

Les éléments sont initialisés avec une valeur construite par défaut.

Voir aussi resize().

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

Construit une liste à partir de la std::initializer_list donnée par args.

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

Construit une liste dont le contenu se trouve dans l'intervalle de l'itérateur [first, last).

Le type de valeur de InputIterator doit être convertible en T.

Contraintes

Participe à la résolution des surcharges uniquement si InputIterator répond aux exigences d'un LegacyInputIterator.

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

Construit une liste avec une taille initiale de size éléments. Chaque élément est initialisé avec value.

Voir aussi resize() et fill().

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

Construit une liste avec une taille initiale de size éléments.

QList tentera de ne pas initialiser les éléments.

Plus précisément, si a un constructeur qui accepte , ce constructeur sera utilisé pour initialiser les éléments :

• si T a un constructeur qui accepte Qt::Uninitialized, ce constructeur sera utilisé pour initialiser les éléments ;
• sinon, chaque élément est construit par défaut. Pour les types trivialement constructibles (tels que int, float, etc.), cela équivaut à ne pas les initialiser.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi resizeForOverwrite().

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

Construit une copie de other.

Cette opération prend un temps constant, car la QList est implicitement partagée. Cela rend le retour d'une QList à partir d'une fonction très rapide. Si une instance partagée est modifiée, elle sera copiée (copy-on-write), ce qui prend un temps linéaire.

Voir également operator=().

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

Move-construit une instance de QList, en la faisant pointer sur le même objet que celui vers lequel other pointait.

[default] QList::~QList()

Détruit la liste.

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

Insère value à la fin de la liste.

Exemple :

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

Cela revient à appeler resize(size() + 1) et à affecter value au nouveau dernier élément de la liste.

Cette opération est relativement rapide, car QList alloue généralement plus de mémoire que nécessaire, ce qui lui permet de s'agrandir sans avoir à réallouer toute la liste à chaque fois.

Voir également operator<<(), prepend() et insert().

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

Déplace les éléments de la liste value à la fin de cette liste.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi operator<<() et operator+=().

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

Exemple :

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)

Ajoute les éléments de la liste value à cette liste.

Voir aussi operator<<() et operator+=().

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

Remplace le contenu de cette liste par une copie des éléments de l.

La taille de cette liste sera égale au nombre d'éléments de l.

Cette fonction n'alloue de la mémoire que si le nombre d'éléments de l dépasse la capacité de cette liste ou si cette liste est partagée.

Cette fonction a été introduite dans Qt 6.6.

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

Remplace le contenu de cette liste par une copie des éléments de l'intervalle de l'itérateur [first, last).

La taille de cette liste sera égale au nombre d'éléments de l'intervalle [first, last).

Cette fonction n'allouera de la mémoire que si le nombre d'éléments de la plage dépasse la capacité de cette liste ou si cette liste est partagée.

Contraintes

Participe à la résolution des surcharges uniquement si InputIterator répond aux exigences d'un LegacyInputIterator.

Cette fonction a été introduite dans Qt 6.6.

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

Remplace le contenu de cette liste par n copies de t.

La taille de cette liste sera égale à n.

Cette fonction n'allouera de la mémoire que si n dépasse la capacité de la liste ou si cette liste est partagée.

Cette fonction a été introduite dans Qt 6.6.

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

Renvoie l'élément à la position d'index i dans la liste.

i doit être une position d'index valide dans la liste (c'est-à-dire 0 <= i < size()).

Voir également value() et operator[]().

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

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à last().

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

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

Renvoie un itérateur de style STL pointant sur le premier élément de la liste.

Voir aussi constBegin() et end().

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

qsizetype QList::capacity() const

Renvoie le nombre maximum d'éléments qui peuvent être stockés dans la liste sans forcer une réallocation.

Le seul but de cette fonction est de fournir un moyen d'affiner l'utilisation de la mémoire de QList. En général, vous n'aurez que rarement besoin d'appeler cette fonction. Si vous voulez savoir combien d'éléments il y a dans la liste, appelez size().

Voir également reserve() et squeeze().

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

Renvoie un itérateur constant de style STL pointant sur le premier élément de la liste.

Voir aussi begin() et cend().

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

Renvoie un itérateur de style STL constant pointant juste après le dernier élément de la liste.

Voir aussi cbegin() et end().

void QList::clear()

Supprime tous les éléments de la liste.

Si cette liste n'est pas partagée, le capacity() est conservé. Utilisez squeeze() pour vous débarrasser de la capacité excédentaire.

Voir également resize() et squeeze().

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

Renvoie un itérateur constant de style STL pointant sur le premier élément de la liste.

Voir aussi begin() et constEnd().

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

Renvoie un pointeur constant vers les données stockées dans la liste. Le pointeur peut être utilisé pour accéder aux éléments de la liste.

Cette fonction est surtout utile pour passer une liste à une fonction qui accepte un tableau C++ simple.

Voir aussi data() et operator[]().

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

Renvoie un itérateur de style STL constant pointant juste après le dernier élément de la liste.

Voir aussi constBegin() et end().

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

Renvoie une référence constante au premier élément de la liste. Cette fonction suppose que la liste n'est pas vide.

Voir aussi constLast(), isEmpty() et first().

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

Renvoie une référence constante au dernier élément de la liste. Cette fonction suppose que la liste n'est pas vide.

Voir aussi constFirst(), isEmpty() et last().

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

Renvoie true si la liste contient une occurrence de value; sinon, renvoie false.

Cette fonction nécessite que le type de valeur ait une implémentation de operator==().

Voir aussi indexOf() et count().

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

Renvoie le nombre d'occurrences de value dans la liste.

Cette fonction exige que le type de valeur ait une implémentation de operator==().

Voir aussi contains() et indexOf().

[constexpr noexcept] qsizetype QList::count() const

Identique à size().

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

Renvoie un itérateur inverse de style STL constant pointant sur le premier élément de la liste, dans l'ordre inverse.

Voir aussi begin(), rbegin(), et rend().

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

Renvoie un itérateur inverse de style STL constant pointant juste après le dernier élément de la liste, dans l'ordre inverse.

Voir aussi end(), rend(), et rbegin().

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

Renvoie un pointeur sur les données stockées dans la liste. Le pointeur peut être utilisé pour accéder aux éléments de la liste et les modifier.

Exemple :

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

Cette fonction est surtout utile pour passer une liste à une fonction qui accepte un tableau C++ simple.

Voir aussi constData() et operator[]().

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

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

Étend le conteneur en insérant un nouvel élément à la position i. Ce nouvel élément est construit sur place en utilisant args comme arguments pour sa construction.

Renvoie un itérateur vers le nouvel élément.

Exemple :

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

Voir aussi emplaceBack.

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

Crée un nouvel élément devant l'élément pointé par l'itérateur before. Ce nouvel élément est construit sur place en utilisant args comme arguments pour sa construction.

Renvoie un itérateur vers le nouvel élément.

Ajoute un nouvel élément à la fin du conteneur. Ce nouvel élément est construit sur place en utilisant args comme arguments pour sa construction.

Renvoie une référence au nouvel élément.

Exemple :

QList<QString> list{"one", "two"} ; list.emplaceBack(3, 'a') ;qDebug() << list;
// liste : ["one", "two", "aaa"]

Il est également possible d'accéder à un objet nouvellement créé en utilisant une référence retournée :

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

C'est la même chose que list.emplace(list.size(), args).

Voir également emplace.

[noexcept] bool QList::empty() const

Cette fonction est fournie pour des raisons de compatibilité avec la STL. Elle est équivalente à isEmpty() et renvoie true si la liste est vide, sinon elle renvoie false.

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

Renvoie un itérateur de style STL pointant juste après le dernier élément de la liste.

Voir aussi begin() et constEnd().

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

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

Renvoie true si cette liste n'est pas vide et si son dernier élément est égal à value; sinon, renvoie false.

Voir aussi isEmpty() et last().

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

Supprime de la liste l'élément pointé par l'itérateur pos et renvoie un itérateur vers l'élément suivant de la liste (qui peut être end()).

La suppression d'un élément préservera la capacité de la liste et ne réduira pas la quantité de mémoire allouée. Pour se débarrasser d'une capacité supplémentaire et libérer autant de mémoire que possible, appelez squeeze().

Voir également insert() et remove().

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

Supprime tous les éléments de begin jusqu'à (mais pas y compris) end. Renvoie un itérateur vers le même élément que celui auquel end faisait référence avant l'appel.

La suppression d'un élément préservera la capacité de la liste et ne réduira pas la quantité de mémoire allouée. Pour se débarrasser d'une capacité supplémentaire et libérer autant de mémoire que possible, appelez squeeze().

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

Attribue value à tous les éléments de la liste. Si size est différent de -1 (valeur par défaut), la liste est préalablement redimensionnée à size.

Exemple :

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

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

Voir aussi resize().

T &QList::first()

Renvoie une référence au premier élément de la liste. Cette fonction suppose que la liste n'est pas vide.

Voir aussi last(), isEmpty() et constFirst().

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

Renvoie une sous-liste contenant les premiers éléments n de cette liste.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi last() et sliced().

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

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

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à first().

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

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

Renvoie la position d'index de la première occurrence de value dans la liste, en effectuant une recherche vers l'avant à partir de la position d'index from. Retourne -1 si aucun élément ne correspond.

Exemple :

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

Cette fonction exige que le type de valeur ait une implémentation de operator==().

Voir également lastIndexOf() et contains().

Insère value à la position d'index i dans la liste. Si i est 0, la valeur est ajoutée à la liste. Si i est size(), la valeur est ajoutée à la liste.

Exemple :

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

Pour les grandes listes, cette opération peut être lente(temps linéaire), car elle nécessite de déplacer tous les éléments aux index i et supérieurs d'une position supplémentaire dans la mémoire. Si vous souhaitez une classe conteneur qui fournisse une fonction insert() rapide, utilisez plutôt std::list.

Voir également append(), prepend() et remove().

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

Insère count copies de value devant l'élément pointé par l'itérateur before. Retourne un itérateur pointant sur le premier des éléments insérés.

Insère value devant l'élément pointé par l'itérateur before. Retourne un itérateur pointant sur l'élément inséré.

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

Insère count copies de value à la position d'index i dans la liste.

Exemple :

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]

[constexpr noexcept] bool QList::isEmpty() const

Renvoie true si la liste a une taille de 0 ; sinon, renvoie false.

Voir aussi size() et resize().

T &QList::last()

Renvoie une référence au dernier élément de la liste. Cette fonction suppose que la liste n'est pas vide.

Voir aussi first(), isEmpty() et constLast().

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

Renvoie une sous-liste contenant les derniers éléments n de cette liste.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi first() et sliced().

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

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

Renvoie la position d'index de la dernière occurrence de la valeur value dans la liste, en effectuant une recherche à rebours à partir de la position d'index from. Si from est égal à -1 (valeur par défaut), la recherche commence au dernier élément. Renvoie -1 si aucun élément ne correspond.

Exemple :

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

Cette fonction exige que le type de valeur ait une implémentation de operator==().

Voir également indexOf().

[constexpr noexcept] qsizetype QList::length() const

Identique à size() et count().

Voir également size() et count().

Elle renvoie le nombre maximal d'éléments que la liste peut théoriquement contenir. En pratique, ce nombre peut être beaucoup plus petit, limité par la quantité de mémoire disponible dans le système.

Ces fonctions ont été introduites dans Qt 6.8.

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

Renvoie une sous-liste contenant des éléments de cette liste, à partir de la position pos. Si length vaut -1 (valeur par défaut), tous les éléments après pos sont inclus ; sinon, les éléments length (ou tous les éléments restants s'il y a moins d'éléments length ) sont inclus.

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

Déplace l'élément à la position d'index from à la position d'index to.

from et to doivent se trouver à l'intérieur des limites.

Par exemple, pour déplacer le premier élément à la fin de la liste :

QList<int> list = {1, 2, 3}; list.move(0, list.size() - 1) ;qDebug() << list; // Prints "QList(2, 3, 1)"

[noexcept] void QList::pop_back()

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à removeLast().

[noexcept] void QList::pop_front()

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à removeFirst().

Insère value au début de la liste.

Exemple :

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

C'est la même chose que list.insert(0, value).

Normalement, cette opération est relativement rapide ( temps constant amorti). QList est capable d'allouer de la mémoire supplémentaire au début des données de la liste et de croître dans cette direction sans réaffecter ou déplacer les données à chaque opération. Cependant, si vous voulez une classe conteneur avec une garantie de temps constant, utilisez std::list à la place, mais préférez QList dans le cas contraire.

Voir aussi append() et insert().

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

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à append(value).

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

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à prepend(value).

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

Renvoie un itérateur inversé de style STL pointant sur le premier élément de la liste, dans l'ordre inverse.

Voir aussi begin(), crbegin(), et rend().

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

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

Supprime les éléments n de la liste, à partir de la position d'index i.

La suppression d'éléments préservera la capacité de la liste et ne réduira pas la quantité de mémoire allouée. Pour se débarrasser de la capacité supplémentaire et libérer autant de mémoire que possible, appelez squeeze().

Voir également insert(), replace() et fill().

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

Supprime de la liste tous les éléments dont la comparaison est égale à t. Renvoie le nombre d'éléments supprimés, le cas échéant.

La suppression d'éléments préserve la capacité de la liste et ne réduit pas la quantité de mémoire allouée. Pour obtenir une capacité supplémentaire et libérer autant de mémoire que possible, appelez squeeze().

Voir également removeOne().

void QList::removeAt(qsizetype i)

Supprime l'élément à la position d'index i. Équivalent à

remove(i);

La suppression d'un élément préservera la capacité de la liste et ne réduira pas la quantité de mémoire allouée. Pour se débarrasser de la capacité supplémentaire et libérer autant de mémoire que possible, appelez squeeze().

Voir également remove().

[noexcept] void QList::removeFirst()

Supprime le premier élément de la liste. Appeler cette fonction équivaut à appeler remove(0). La liste ne doit pas être vide. Si la liste peut être vide, appelez isEmpty() avant d'appeler cette fonction.

La suppression d'un élément préservera la capacité de la liste et ne réduira pas la quantité de mémoire allouée. Pour se débarrasser d'une capacité supplémentaire et libérer autant de mémoire que possible, appelez squeeze().

Voir également remove(), takeFirst() et isEmpty().

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

Supprime de la liste tous les éléments pour lesquels le prédicat pred renvoie la valeur true. Renvoie le nombre d'éléments supprimés, le cas échéant.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi removeAll().

[noexcept] void QList::removeLast()

Supprime le dernier élément de la liste. Appeler cette fonction équivaut à appeler remove(size() - 1). La liste ne doit pas être vide. Si la liste peut être vide, appelez isEmpty() avant d'appeler cette fonction.

La suppression d'un élément préservera la capacité de la liste et ne réduira pas la quantité de mémoire allouée. Pour se débarrasser d'une capacité supplémentaire et libérer autant de mémoire que possible, appelez squeeze().

Voir aussi remove(), takeLast(), removeFirst() et isEmpty().

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

Supprime de la liste le premier élément dont la comparaison est égale à t. Retourne si un élément a effectivement été supprimé.

La suppression d'un élément préservera la capacité de la liste et ne réduira pas la quantité de mémoire allouée. Pour se débarrasser d'une capacité supplémentaire et libérer autant de mémoire que possible, appelez squeeze().

Voir également removeAll().

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

Renvoie un itérateur inversé de style STL pointant juste après le dernier élément de la liste, dans l'ordre inverse.

Voir aussi end(), crend(), et rbegin().

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

Remplace l'élément à la position d'index i par value.

i doit être une position d'index valide dans la liste (c'est-à-dire 0 <= i < size()).

Voir également operator[]() et remove().

void QList::reserve(qsizetype size)

Tente d'allouer de la mémoire pour au moins size éléments.

Si vous connaissez à l'avance la taille de la liste, vous devriez appeler cette fonction pour éviter les réallocations et la fragmentation de la mémoire. Si vous redimensionnez souvent la liste, vous obtiendrez probablement de meilleures performances.

En cas de doute sur la quantité d'espace nécessaire, il est généralement préférable d'utiliser une borne supérieure comme size, ou une estimation élevée de la taille la plus probable, si une borne supérieure stricte serait beaucoup plus grande que cela. Si size est une sous-estimation, la liste s'allongera en fonction des besoins une fois que la taille réservée sera dépassée, ce qui peut conduire à une allocation plus importante que ne l'aurait fait votre meilleure surestimation et ralentira l'opération qui la déclenche.

Voir également squeeze(), capacity() et resize().

Fixe la taille de la liste à size. Si size est supérieur à la taille actuelle, des éléments sont ajoutés à la fin ; les nouveaux éléments sont initialisés avec une valeur construite par défaut ou c. Si size est inférieur à la taille actuelle, des éléments sont retirés de la fin.

Si cette liste n'est pas partagée, le capacity() est conservé. Utilisez squeeze() pour vous débarrasser de la capacité excédentaire.

Ces fonctions ont été introduites dans Qt 6.0.

Voir aussi size().

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

Fixe la taille de la liste à size. Si size est inférieur à la taille actuelle, des éléments sont retirés de la fin. Si size est supérieur à la taille actuelle, des éléments sont ajoutés à la fin ; QList tentera de ne pas initialiser ces nouveaux éléments.

Plus précisément :

• si T a un constructeur qui accepte Qt::Uninitialized, ce constructeur sera utilisé pour initialiser les éléments ;
• sinon, chaque élément est construit par défaut. Pour les types trivialement constructibles (tels que int, float, etc.), cela équivaut à ne pas les initialiser.

Cette fonction a été introduite dans Qt 6.8.

void QList::shrink_to_fit()

Cette fonction est fournie pour la compatibilité STL. Elle est équivalente à squeeze().

[constexpr noexcept] qsizetype QList::size() const

Renvoie le nombre d'éléments de la liste.

Voir aussi isEmpty() et resize().

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

Renvoie une sous-liste contenant n éléments de cette liste, à partir de la position pos.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi first() et last().

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

Renvoie une sous-liste contenant les éléments de cette liste à partir de la position pos et jusqu'à la fin.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi first() et last().

void QList::squeeze()

Libère la mémoire qui n'est pas nécessaire pour stocker les éléments.

Le seul but de cette fonction est de fournir un moyen d'affiner l'utilisation de la mémoire de QList. En général, vous n'aurez que rarement besoin d'appeler cette fonction.

Voir aussi reserve() et capacity().

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

Renvoie true si cette liste n'est pas vide et si son premier élément est égal à value; sinon, renvoie false.

Voir aussi isEmpty() et first().

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

Remplace cette liste par other. Cette opération est très rapide et n'échoue jamais.

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

Échangez l'élément à la position d'index i avec l'élément à la position d'index j. Cette fonction suppose que i et j sont au moins égaux à 0 et inférieurs à size(). Pour éviter un échec, vérifiez que i et j sont au moins égaux à 0 et inférieurs à size().

T QList::takeAt(qsizetype i)

Supprime l'élément à la position d'index i et le renvoie.

Équivalent à

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

Voir également takeFirst() et takeLast().

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

Supprime le premier élément de la liste et le renvoie. Cette fonction suppose que la liste n'est pas vide. Pour éviter un échec, appelez isEmpty() avant d'appeler cette fonction.

Voir également takeLast() et removeFirst().

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

Supprime le dernier élément de la liste et le renvoie. Cette fonction suppose que la liste n'est pas vide. Pour éviter un échec, appelez isEmpty() avant d'appeler cette fonction.

Si vous n'utilisez pas la valeur de retour, removeLast() est plus efficace.

Voir également takeFirst() et removeLast().

T QList::value(qsizetype i) const

Renvoie la valeur à la position d'index i dans la liste.

Si l'index i est hors limites, la fonction renvoie une valeur construite par défaut. Si vous êtes certain que i est dans les limites, vous pouvez utiliser at() à la place, ce qui est légèrement plus rapide.

Voir aussi at() et operator[]().

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

Si l'index i est hors limites, la fonction renvoie defaultValue.

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

Renvoie true si other n'est pas égal à cette liste ; sinon, renvoie false.

Deux listes sont considérées comme égales si elles contiennent les mêmes valeurs dans le même ordre.

Cette fonction nécessite que le type de valeur ait une implémentation de operator==().

Voir également operator==().

Renvoie une liste contenant tous les éléments de cette liste suivis de tous les éléments de la liste other.

Voir aussi operator+=().

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

Ajoute les éléments de la liste other à cette liste et renvoie une référence à cette liste.

Voir aussi operator+() et append().

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

Cette fonction a été introduite dans Qt 6.0.

Voir aussi operator+() et append().

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

Ajoute value à la liste.

Voir aussi append() et operator<<().

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

Voir aussi append() et operator<<().

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

Renvoie true si cette liste est lexicalement inférieure à other; sinon, renvoie false.

Cette fonction nécessite que le type de valeur ait une implémentation de operator<().

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

Ajoute value à la liste et renvoie une référence à cette liste.

Voir aussi append() et operator+=().

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

Ajoute other à la liste et renvoie une référence à la liste.

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

Cette fonction a été introduite dans Qt 6.0.

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

Voir aussi append() et operator+=().

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

Renvoie true si cette liste est lexicalement inférieure ou égale à other; sinon, renvoie false.

Cette fonction nécessite que le type de valeur ait une implémentation de operator<().

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

Move-assigne other à cette instance QList.

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

Affecte other à cette liste et renvoie une référence à cette liste.

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

Attribue la collection de valeurs de args à cette instance QList.

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

Renvoie true si other est égal à cette liste ; sinon, renvoie false.

Deux listes sont considérées comme égales si elles contiennent les mêmes valeurs dans le même ordre.

Cette fonction nécessite que le type de valeur ait une implémentation de operator==().

Voir également operator!=().

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

Renvoie true si cette liste est lexicalement plus grande que other; sinon, renvoie false.

Cette fonction nécessite que le type de valeur ait une implémentation de operator<().

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

Renvoie true si cette liste est lexicalement supérieure ou égale à other; sinon, renvoie false.

Cette fonction nécessite que le type de valeur ait une implémentation de operator<().

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

Renvoie l'élément à la position d'index i sous la forme d'une référence modifiable.

i doit être une position d'index valide dans la liste (c'est-à-dire 0 <= i < size()).

Notez que l'utilisation d'opérateurs non-const peut amener QList à effectuer une copie profonde.

Voir également at() et value().

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

Identique à at(i).