QList Class

Documentation des fonctions membres

[constexpr noexcept default] QList::QList()

Crée une liste vide.

Voir aussi resize().

[explicit] QList::QList(qsizetype size)

Crée une liste dont la taille initiale est de size éléments.

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

Voir également resize().

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

Crée une liste à partir de la liste d'initialisation std::initializer_list fournie par args.

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

Crée une liste contenant les éléments de la plage de l'itérateur [first, last).

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

Contraintes

Ne participe à la résolution des surcharges que si InputIterator répond aux exigences d’un LegacyInputIterator.

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

Crée une liste dont la taille initiale est de size éléments. Chaque élément est initialisé à value.

Voir également resize() et fill().

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

Crée une liste dont la taille initiale est de size.

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

Plus précisément :

• si T dispose d’un constructeur acceptant Qt::Uninitialized, ce constructeur sera utilisé pour initialiser les éléments ;
• sinon, chaque élément est initialisé par défaut. Pour les types facilement constructibles (tels que int, float, etc.), cela revient à ne pas les initialiser.

Cette fonction a été introduite dans Qt 6.8.

Voir également resizeForOverwrite().

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

Crée une copie de ` other`.

Cette opération s'effectue en temps constant, car QList est implicitement partagée. Cela rend le retour d'une QList depuis une fonction très rapide. 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=().

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

Crée une instance de QList par « move », de sorte qu'elle pointe vers le même objet que celui vers lequel pointait other.

[implicit] QList::~QList()

Supprime 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 à attribuer value au nouvel élément de fin 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'étendre sans avoir à réallouer la liste entière à 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 également ` 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 également 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 contenus dans 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 celle-ci 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 celle-ci est partagée.

Contraintes

Ne participe à la résolution des surcharges que 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 situé à l'index i dans la liste.

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

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

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

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle est équivalente à ` last()`.

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

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

Renvoie un itérateur de type STL pointant vers le premier élément de la liste.

Voir également ` constBegin()` et ` end()`.

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

qsizetype QList::capacity() const

Renvoie le nombre maximal d'éléments pouvant être stockés dans la liste sans nécessiter de réallocation.

Cette fonction a pour seul but de permettre d'ajuster avec précision l'utilisation de la mémoire par QList. En général, vous n'aurez que très rarement besoin d'appeler cette fonction. Si vous souhaitez connaître le nombre d'éléments contenus dans la liste, appelez size().

Voir également reserve() et squeeze().

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

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

Voir également ` begin()` et ` cend()`.

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

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

Voir également ` cbegin()` et ` end()`.

void QList::clear()

Supprime tous les éléments de la liste.

Si cette liste n'est pas partagée, l'capacity() est conservée. Utilisez squeeze() pour libérer de la capacité excédentaire.

Voir aussi resize() et squeeze().

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

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

Voir aussi ` begin()` et ` constEnd()`.

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

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

Cette fonction est particulièrement utile pour transmettre une liste à une fonction qui accepte un tableau C++ classique.

Voir également ` data()` et ` operator[]()`.

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

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

Voir également ` constBegin()` et ` end()`.

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

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

Voir également constLast(), isEmpty() et first().

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

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

Voir également 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 dispose d’une implémentation de ` operator==()`.

Voir également 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 nécessite que le type de valeur dispose d'une implémentation de ` operator==()`.

Voir également ` contains()` et ` indexOf()`.

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

Identique à ` size()`.

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

Renvoie un itérateur inversé de type STL (const) pointant vers le premier élément de la liste, dans l'ordre inverse.

Voir également ` begin()`, ` rbegin()` et ` rend()`.

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

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

Voir également ` end()`, ` rend()` et ` rbegin()`.

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

Renvoie un pointeur vers les données stockées dans la liste. Ce pointeur permet d'accéder aux éléments de la liste et de 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 transmettre une liste à une fonction qui accepte un tableau C++ classique.

Voir également ` constData()` et ` operator[]()`.

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

void QList::detach()

Garantit que les données de cette instance QList ne sont plus partagées avec d'autres instances.

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 in situ à l'aide de args comme arguments de 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 également 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 de construction.

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

Ajoute un nouvel élément à la fin du conteneur. Ce nouvel élément est créé sur place à l'aide de l'args, qui sert d'arguments pour sa création.

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

Exemple :

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

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

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

Cela revient à list.emplace(list.size(), args).

Voir également emplace.

[noexcept] bool QList::empty() const

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` isEmpty()`, qui renvoie ` true ` si la liste est vide ; dans le cas contraire, elle renvoie ` false`.

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

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

Voir également ` 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 que son dernier élément est égal à value; sinon, renvoie false.

Voir également 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éserve la capacité de la liste et ne réduit pas la quantité de mémoire allouée. Pour réduire la capacité excédentaire 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'à (sans inclure) 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’éléments préserve la capacité de la liste et ne réduit pas la quantité de mémoire allouée. Pour réduire la capacité excédentaire et libérer autant de mémoire que possible, appelez squeeze().

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

Attribue la valeur « value » à tous les éléments de la liste. Si la valeur « size » est différente de -1 (valeur par défaut), la liste est préalablement redimensionnée à la valeur « 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 également last(), isEmpty() et constFirst().

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

Renvoie une sous-liste contenant les x n premiers éléments 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 à des fins de compatibilité avec la STL. Elle équivaut à ` first()`.

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

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

Renvoie l'index de la première occurrence de « value » dans la liste, en effectuant une recherche vers l'avant à partir de l'index « from ». Renvoie -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 nécessite que le type de valeur dispose d’une implémentation de la méthode ` operator==()`.

Voir également lastIndexOf() et contains().

Insère value à l'index i dans la liste. Si i vaut 0, la valeur est ajoutée au début de la liste. Si i vaut size(), la valeur est ajoutée à la fin de 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 d’une position vers l’avant en mémoire tous les éléments situés aux indices i et au-delà. Si vous souhaitez une classe de conteneur fournissant 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 exemplaires de value devant l'élément pointé par l'itérateur before. Renvoie un itérateur pointant vers le premier des éléments insérés.

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

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

Insère count exemplaires 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 égale à 0 ; sinon, renvoie false.

Voir également size() et resize().

T &QList::last()

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

Voir également first(), isEmpty() et constLast().

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

Renvoie une sous-liste contenant les x éléments de cette liste dont la valeur « n » est la plus récente.

Cette fonction a été introduite dans Qt 6.0.

Voir également ` first()` et ` sliced()`.

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

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

Renvoie l'index de la dernière occurrence de la valeur value dans la liste, en effectuant une recherche à rebours à partir de l'index from. Si from est égal à -1 (valeur par défaut), la recherche commence à partir du 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 nécessite que le type de valeur dispose d’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 bien inférieur, car il est limité par la quantité de mémoire disponible sur 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 les éléments de cette liste, à partir de la position pos. Si length vaut -1 (valeur par défaut), tous les éléments situés après pos sont inclus ; sinon, length éléments (ou tous les éléments restants s'il y en a moins que length ) sont inclus.

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

Déplace l'élément situé à l'index from vers l'index to.

from to et doivent se situer dans les limites autorisées.

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 à des fins de compatibilité avec la STL. Elle équivaut à ` removeLast()`.

[noexcept] void QList::pop_front()

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` 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"]

Cela revient au même 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 de la liste et de s’étendre dans cette direction sans réallouer ni déplacer les données à chaque opération. Cependant, si vous souhaitez une classe de conteneur garantissant un temps constant pour l’ajout en tête, utilisez plutôt std::list, mais privilégiez QList dans le cas contraire.

Voir également append() et insert().

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

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à `append(value)`.

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

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à `prepend(value)`.

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

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

Voir également begin(), crbegin() et rend().

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

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

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

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 réduire la capacité excédentaire et libérer autant de mémoire que possible, appelez la fonction ` 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 valeur 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 réduire la capacité excédentaire et libérer autant de mémoire que possible, appelez la fonction squeeze().

Voir également removeOne().

void QList::removeAt(qsizetype i)

Supprime l'élément situé à l'index i. Équivalent à

remove(i);

La suppression d’un élément préserve la capacité de la liste et ne réduit pas la quantité de mémoire allouée. Pour réduire la capacité excédentaire 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. L'appel de cette fonction équivaut à l'appel de `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éserve la capacité de la liste et ne réduit pas la quantité de mémoire allouée. Pour réduire la capacité excédentaire 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 « vrai ». Renvoie le nombre d'éléments supprimés, le cas échéant.

Cette fonction a été introduite dans Qt 6.1.

Voir également removeAll().

[noexcept] void QList::removeLast()

Supprime le dernier élément de la liste. L'appel de cette fonction équivaut à l'appel de `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éserve la capacité de la liste et ne réduit pas la quantité de mémoire allouée. Pour réduire la capacité excédentaire et libérer autant de mémoire que possible, appelez ` squeeze()`.

Voir également 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 valeur est égale à « t ». Indique si un élément a effectivement été supprimé.

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 réduire la capacité excédentaire et libérer autant de mémoire que possible, appelez la fonction squeeze().

Voir également removeAll().

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

Renvoie un itérateur inversé de type 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 situé à l'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 l'espace nécessaire, il est généralement préférable d'utiliser une borne supérieure égale à ` size`, ou une estimation haute de la taille la plus probable, si une borne supérieure stricte s'avère nettement supérieure à cette valeur. Si ` size ` est une sous-estimation, la liste s’agrandira selon les besoins dès que la taille réservée sera dépassée, ce qui peut entraîner une allocation plus importante que ne l’aurait été votre meilleure surestimation et ralentira l’opération qui la déclenche.

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

Définit 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 soit avec une valeur construite par défaut, soit avec ` c`. Si ` size ` est inférieur à la taille actuelle, des éléments sont supprimés à la fin.

Si cette liste n’est pas partagée, la fonction ` capacity()` est conservée. Utilisez ` squeeze()` pour libérer la capacité excédentaire.

Ces fonctions ont été introduites dans Qt 6.0.

Voir également size().

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

Définit la taille de la liste à size. Si size est inférieure à la taille actuelle, des éléments sont supprimés à la fin. Si size est supérieure à 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 dispose d’un constructeur acceptant Qt::Uninitialized, ce constructeur sera utilisé pour initialiser les éléments ;
• sinon, chaque élément est initialisé par défaut. Pour les types facilement constructibles (tels que int, float, etc.), cela revient à ne pas les initialiser.

Cette fonction a été introduite dans Qt 6.8.

void QList::shrink_to_fit()

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` squeeze()`.

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

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

Voir également 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 également 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 jusqu'à la fin de celle-ci.

Cette fonction a été introduite dans Qt 6.0.

Voir également first() et last().

void QList::squeeze()

Libère toute la mémoire qui n'est pas nécessaire au stockage des éléments.

Le seul objectif de cette fonction est de permettre un réglage fin de l'utilisation de la mémoire par QList. En général, vous n'aurez que très rarement besoin d'appeler cette fonction.

Voir également 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 également isEmpty() et first().

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

Permute cette liste avec celle de other. Cette opération est très rapide et ne pose jamais de problème.

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

Échange la valeur située à l'indice i avec celle située à l'indice j. Cette fonction suppose que i et j sont toutes deux au moins égales à 0 mais inférieures à size(). Pour éviter tout échec, vérifiez que i et j sont toutes deux au moins égales à 0 et inférieures à size().

T QList::takeAt(qsizetype i)

Supprime l'élément situé à l'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 toute erreur, appelez la fonction isEmpty() avant d'appeler cette fonction.

Voir également takeLast() et removeFirst().

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

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

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

Voir également takeFirst() et removeLast().

T QList::value(qsizetype i) const

Renvoie la valeur située à l'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 se trouve dans les limites, vous pouvez utiliser at() à la place, ce qui est légèrement plus rapide.

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

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

Si l'indice « 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 dispose d’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 également operator+() et append().

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

Cette fonction a été introduite dans Qt 6.0.

Voir également operator+() et append().

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

Ajoute value à la liste.

Voir également append() et operator<<().

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

Voir également 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 dispose d'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 également append() et operator+=().

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

Ajoute « other » à la liste et renvoie une référence à celle-ci.

[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 également 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 dispose d’une implémentation de operator<().

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

Cette commande attribue « other » à cette instance de « QList ».

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

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

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

Attribue l'ensemble des valeurs contenues dans args à cette instance de 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 dispose d’une implémentation de operator==().

Voir également operator!=().

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

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

Cette fonction nécessite que le type de valeur dispose d’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 dispose d’une implémentation de ` operator<()`.

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

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

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

Notez que l'utilisation d'opérateurs non const peut entraîner une copie profonde de QList.

Voir également at() et value().

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

Comme sur (i).