QStringList Class

Documentation des fonctions membres

QStringList::QStringList(const QList<QString> &other)

Construit une copie de other.

Cette opération prend un temps constant, car QStringList est implicitement partagée. Cela rend le retour d'une QStringList à 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=().

QStringList::QStringList(const QString &str)

Construit une liste de chaînes qui contient la chaîne donnée, str. Des listes plus longues peuvent être facilement créées de cette manière :

    QStringList longerList = (QStringList() << str1 << str2 << str3);

Voir aussi append().

QStringList::QStringList(QList<QString> &&other)

Déplacement-construction de QList<QString>.

Après une construction réussie, other sera vide.

[noexcept] bool QStringList::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Renvoie true si la liste contient la chaîne str; sinon, renvoie false.

Si cs est Qt::CaseSensitive (par défaut), la comparaison des chaînes est sensible à la casse ; sinon, la comparaison est insensible à la casse.

Voir aussi indexOf(), lastIndexOf() et QString::contains().

[noexcept] bool QStringList::contains(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Renvoie true si la liste contient la chaîne de caractères latins-1 visualisée par str; sinon, renvoie false.

Si cs est Qt::CaseSensitive (par défaut), la comparaison des chaînes est sensible à la casse ; sinon, la comparaison est insensible à la casse.

Voir aussi indexOf(), lastIndexOf() et QString::contains().

[noexcept] bool QStringList::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Renvoie true si la liste contient la chaîne str; sinon, renvoie false.

Si cs est Qt::CaseSensitive (par défaut), la comparaison des chaînes est sensible à la casse ; sinon, la comparaison est insensible à la casse.

[since 6.9] QStringList QStringList::filter(const QLatin1StringMatcher &matcher) const

Renvoie une liste de toutes les chaînes de caractères correspondant à matcher (c'est-à-dire pour lesquelles matcher.indexIn() renvoie un index >= 0).

L'utilisation de QLatin1StringMatcher peut s'avérer plus rapide lorsque la recherche s'effectue dans de grandes listes et/ou dans des listes contenant de longues chaînes de caractères (la meilleure façon de le savoir est de procéder à une analyse comparative).

Par exemple, cette fonction a été introduite dans Qt 6 :

    QStringList veryLargeList;
    QLatin1StringMatcher matcher("Street"_L1, Qt::CaseInsensitive);
    QStringList filtered = veryLargeList.filter(matcher);

Cette fonction a été introduite dans Qt 6.9.

Voir aussi contains() et filter(const QStringMatcher &).

QStringList QStringList::filter(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Renvoie une liste de toutes les chaînes contenant la sous-chaîne str.

Si cs est Qt::CaseSensitive (par défaut), la comparaison des chaînes est sensible à la casse ; sinon, la comparaison est insensible à la casse.

    QStringList list;
    list << "Bill Murray" << "John Doe" << "Bill Clinton";

    QStringList result;
    result = list.filter("Bill");
    // result: ["Bill Murray", "Bill Clinton"]

Ceci est équivalent à

    QStringList result;
    for (const auto &str : std::as_const(list)) {
        if (str.contains("Bill"))
            result += str;
    }

Voir aussi contains().

QStringList QStringList::filter(const QRegularExpression &re) const

Renvoie une liste de toutes les chaînes de caractères qui correspondent à l'expression régulière re.

[since 6.7] QStringList QStringList::filter(const QStringMatcher &matcher) const

Renvoie une liste de toutes les chaînes de caractères correspondant à matcher (c'est-à-dire pour lesquelles matcher.indexIn() renvoie un index >= 0).

L'utilisation de QStringMatcher peut s'avérer plus rapide lorsque la recherche s'effectue dans de grandes listes et/ou dans des listes contenant de longues chaînes de caractères (la meilleure façon de le savoir est de procéder à une analyse comparative).

Par exemple, il s'agit d'une fonction surchargée :

    QStringList veryLongList;
    QStringMatcher matcher(u"Straße", Qt::CaseInsensitive);
    QStringList filtered = veryLongList.filter(matcher);

Cette fonction a été introduite dans Qt 6.7.

Voir aussi contains() et filter(const QLatin1StringMatcher &).

[since 6.7] QStringList QStringList::filter(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Cette fonction a été introduite dans Qt 6.7.

QStringList QStringList::filter(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Renvoie la position d'index de la première correspondance de str dans la liste, en cherchant vers l'avant à partir de la position d'index from. Renvoie -1 si aucun élément ne correspond.

Si cs est Qt::CaseSensitive (par défaut), la comparaison des chaînes est sensible à la casse ; sinon, la comparaison est insensible à la casse.

Voir aussi lastIndexOf().

qsizetype QStringList::indexOf(const QRegularExpression &re, qsizetype from = 0) const

Renvoie la position d'index de la première correspondance exacte de re dans la liste, en cherchant vers l'avant à partir de la position d'index from. Renvoie -1 si aucun élément ne correspond.

Voir aussi lastIndexOf().

QString QStringList::join(const QString &separator) const

Réunit toutes les chaînes de la liste de chaînes en une seule chaîne dont chaque élément est séparé par la chaîne donnée separator (qui peut être une chaîne vide).

Voir aussi QString::split().

QString QStringList::join(QChar separator) const

QString QStringList::join(QLatin1StringView separator) const

QString QStringList::join(QStringView separator) const

Renvoie la position d'index de la dernière correspondance de str 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. Retourne -1 si aucun élément ne correspond.

Si cs est Qt::CaseSensitive (par défaut), la comparaison des chaînes est sensible à la casse ; sinon, la comparaison est insensible à la casse.

Voir aussi indexOf().

qsizetype QStringList::lastIndexOf(const QRegularExpression &re, qsizetype from = -1) const

Renvoie la position d'index de la dernière correspondance exacte de re 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. Retourne -1 si aucun élément ne correspond.

Voir également indexOf().

qsizetype QStringList::removeDuplicates()

Cette fonction supprime les doublons d'une liste. Les entrées ne doivent pas être triées. Elles conserveront leur ordre d'origine.

Elle renvoie le nombre d'entrées supprimées.

QStringList &QStringList::replaceInStrings(const QString &before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Renvoie une liste de chaînes dont le texte before a été remplacé par le texte after partout où se trouve le texte before.

Si cs est Qt::CaseSensitive (par défaut), la comparaison des chaînes est sensible à la casse ; sinon, la comparaison est insensible à la casse.

Dans le cas contraire, la comparaison est insensible à la casse :

    QStringList list;
    list << "alpha" << "beta" << "gamma" << "epsilon";
    list.replaceInStrings("a", "o");
    // list == ["olpho", "beto", "gommo", "epsilon"]

Voir aussi QString::replace().

QStringList &QStringList::replaceInStrings(const QRegularExpression &re, const QString &after)

Remplace chaque occurrence de l'expression régulière re, dans chacune des chaînes de la liste de chaînes, par after. Renvoie une référence à la liste de chaînes.

Par exemple :

    QStringList list;
    list << "alpha" << "beta" << "gamma" << "epsilon";
    list.replaceInStrings(QRegularExpression("^a"), "o");
    // list == ["olpha", "beta", "gamma", "epsilon"]

Pour les expressions régulières qui contiennent des groupes de capture, les occurrences de \1, \2..., dans after sont remplacées par la chaîne capturée par le groupe de capture correspondant.

Par exemple, cette fonction est surchargée :

    QStringList list;
    list << "Bill Clinton" << "Murray, Bill";
    list.replaceInStrings(QRegularExpression("^(.*), (.*)$"), "\\2 \\1");
    // list == ["Bill Clinton", "Bill Murray"]

QStringList &QStringList::replaceInStrings(QStringView before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

QStringList &QStringList::replaceInStrings(QStringView before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

QStringList &QStringList::replaceInStrings(const QString &before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

void QStringList::sort(Qt::CaseSensitivity cs = Qt::CaseSensitive)

Trie la liste des chaînes dans l'ordre croissant.

Si cs est Qt::CaseSensitive (par défaut), la comparaison des chaînes est sensible à la casse ; sinon, la comparaison est insensible à la casse.

Le tri est effectué à l'aide de l'algorithme std::sort() du STL, qui prend en moyenne un temps logarithmique linéaire, c'est-à-dire O(n log n).

Si vous souhaitez trier vos chaînes dans un ordre arbitraire, vous pouvez utiliser la classe QMap. Par exemple, vous pouvez utiliser une classe QMap<QString, QString> pour créer un ordre insensible à la casse (par exemple, les clés étant des versions en minuscules des chaînes et les valeurs étant les chaînes), ou une classe QMap<int, QString> pour trier les chaînes en fonction d'un indice entier.

QStringList QStringList::operator+(const QStringList &other) const

Renvoie une liste de chaînes qui est la concaténation de cette liste de chaînes avec la liste de chaînes other.

Voir aussi append().

QStringList &QStringList::operator<<(const QString &str)

Ajoute la chaîne donnée, str, à cette liste de chaînes et renvoie une référence à la liste de chaînes.

Voir aussi append().

QStringList &QStringList::operator<<(const QList<QString> &other)

Ajoute la liste de chaînes other à la liste de chaînes et renvoie une référence à cette dernière liste de chaînes.

QStringList &QStringList::operator<<(const QStringList &other)

Ajoute la liste de chaînes other à la liste de chaînes et renvoie une référence à cette dernière liste de chaînes.

QStringList &QStringList::operator=(const QList<QString> &other)

Copie de l'opérateur d'affectation de QList<QString>. Affecte la liste de chaînes de caractères other à cette liste de chaînes de caractères.

Après l'opération, other et *this seront égaux.

QStringList &QStringList::operator=(QList<QString> &&other)

Déplacement de l'opérateur d'affectation de QList<QString>. Déplace la liste de chaînes de caractères other vers cette liste de chaînes de caractères.

Après l'opération, other sera vide.