QStringList Class

Dokumentation der Mitgliedsfunktionen

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

Wenn cs gleich Qt::CaseSensitive ist (Standardeinstellung), wird beim String-Vergleich zwischen Groß- und Kleinschreibung unterschieden; andernfalls ist der Vergleich unabhängig von der Groß- und Kleinschreibung.

Siehe auch lastIndexOf().

Gibt die Indexposition der letzten Übereinstimmung von str in der Liste zurück, wobei ab der Indexposition from rückwärts gesucht wird. Ist from gleich -1 (Standard), beginnt die Suche beim letzten Eintrag. Gibt -1 zurück, wenn kein Element übereinstimmt.

Wenn cs gleich Qt::CaseSensitive ist (Standardeinstellung), wird beim Vergleich der Zeichenketten zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird die Groß- und Kleinschreibung nicht berücksichtigt.

Siehe auch indexOf().

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

Konstruiert eine Kopie von other.

Dieser Vorgang benötigt konstante Zeit, da QStringList implizit gemeinsam genutzt wird. Das macht die Rückgabe einer QStringList 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=().

QStringList::QStringList(const QString &str)

Konstruiert eine String-Liste, die die angegebene Zeichenkette enthält, str. Längere Listen lassen sich auf diese Weise leicht erstellen:

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

Siehe auch append().

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

Dies ist eine überladene Funktion.

Verschiebe-Konstruktionen von QList<QString>.

Nach einer erfolgreichen Konstruktion ist other leer.

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

Gibt true zurück, wenn die Liste die Zeichenfolge str enthält; andernfalls wird false zurückgegeben.

Wenn cs gleich Qt::CaseSensitive ist (Standardeinstellung), wird beim Vergleich der Zeichenketten zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird die Groß- und Kleinschreibung nicht berücksichtigt.

Siehe auch indexOf(), lastIndexOf(), und QString::contains().

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

Dies ist eine überladene Funktion.

Gibt true zurück, wenn die Liste die von str betrachtete Latin-1-Zeichenkette enthält; andernfalls gibt sie false zurück.

Wenn cs gleich Qt::CaseSensitive ist (Standardeinstellung), wird beim Vergleich der Zeichenketten zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird die Groß- und Kleinschreibung nicht berücksichtigt.

Siehe auch indexOf(), lastIndexOf(), und QString::contains().

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

Dies ist eine überladene Funktion.

Gibt true zurück, wenn die Liste die Zeichenkette str enthält; andernfalls gibt sie false zurück.

Wenn cs gleich Qt::CaseSensitive ist (Standardeinstellung), wird beim Vergleich der Zeichenketten zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird die Groß- und Kleinschreibung nicht berücksichtigt.

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

Gibt eine Liste aller Zeichenketten zurück, die die Teilzeichenkette str enthalten.

Wenn cs gleich Qt::CaseSensitive ist (Standardeinstellung), wird beim Vergleich der Zeichenketten zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird die Groß- und Kleinschreibung nicht berücksichtigt.

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

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

Dies ist äquivalent zu

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

Siehe auch contains().

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

Dies ist eine überladene Funktion.

Gibt eine Liste aller Zeichenketten zurück, die mit dem regulären Ausdruck re übereinstimmen.

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

Dies ist eine überladene Funktion.

Gibt eine Liste aller Zeichenketten zurück, die mit matcher übereinstimmen (d.h. für die matcher.indexIn() einen Index >= 0 liefert).

Die Verwendung von QStringMatcher kann bei der Suche in großen Listen und/oder in Listen mit langen Zeichenfolgen schneller sein (der beste Weg, dies herauszufinden, ist ein Benchmarking).

Ein Beispiel:

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

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch contains().

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

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.7 eingeführt.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

Gibt die Indexposition der ersten exakten Übereinstimmung von re in der Liste zurück, wobei ab der Indexposition from vorwärts gesucht wird. Gibt -1 zurück, wenn kein Element übereinstimmt.

Siehe auch lastIndexOf().

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

Verbindet alle Strings der String-Liste zu einem einzigen String, wobei jedes Element durch den angegebenen separator (der ein leerer String sein kann) getrennt ist.

Siehe auch QString::split().

QString QStringList::join(QChar separator) const

Diese Funktion überlastet join().

QString QStringList::join(QLatin1StringView separator) const

Diese Funktion überlastet join().

QString QStringList::join(QStringView separator) const

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

Gibt die Indexposition der letzten exakten Übereinstimmung von re in der Liste zurück, wobei ab der Indexposition from rückwärts gesucht wird. Ist from gleich -1 (Standard), beginnt die Suche beim letzten Eintrag. Gibt -1 zurück, wenn kein Element übereinstimmt.

Siehe auch indexOf().

qsizetype QStringList::removeDuplicates()

Diese Funktion entfernt doppelte Einträge aus einer Liste. Die Einträge müssen nicht sortiert werden. Sie behalten ihre ursprüngliche Reihenfolge bei.

Gibt die Anzahl der entfernten Einträge zurück.

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

Gibt eine Zeichenkettenliste zurück, in der bei jeder Zeichenkette der Text before durch den Text after ersetzt wurde, wo immer der Text before gefunden wurde.

Wenn cs gleich Qt::CaseSensitive ist (Standardeinstellung), wird beim Vergleich der Zeichenketten zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird die Groß- und Kleinschreibung nicht berücksichtigt.

Ein Beispiel:

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

Siehe auch QString::replace().

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

Dies ist eine überladene Funktion.

Ersetzt jedes Vorkommen des regulären Ausdrucks re in jeder Zeichenkette der Liste durch after. Gibt einen Verweis auf die Zeichenkettenliste zurück.

Ein Beispiel:

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

Bei regulären Ausdrücken, die Erfassungsgruppen enthalten, wird das Vorkommen von \1, \2, ..., in after durch die von der entsprechenden Erfassungsgruppe erfasste Zeichenfolge ersetzt.

Ein Beispiel:

    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)

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Sortiert die Liste der Zeichenketten in aufsteigender Reihenfolge.

Wenn cs Qt::CaseSensitive ist (Standardeinstellung), wird beim Vergleich der Zeichenketten zwischen Groß- und Kleinschreibung unterschieden; andernfalls ist der Vergleich unabhängig von der Groß- und Kleinschreibung.

Die Sortierung erfolgt mit dem std::sort()-Algorithmus der STL, der im Durchschnitt linear-logarithmische Zeit benötigt, d. h. O(n log n).

Wenn Sie Ihre Zeichenketten in einer beliebigen Reihenfolge sortieren möchten, sollten Sie die Klasse QMap verwenden. Sie könnten z. B. QMap<QString, QString> verwenden, um eine Sortierung ohne Berücksichtigung der Groß- und Kleinschreibung zu erstellen (z. B. wenn die Schlüssel Kleinbuchstaben-Versionen der Zeichenketten sind und die Werte die Zeichenketten), oder QMap<int, QString>, um die Zeichenketten nach einem ganzzahligen Index zu sortieren.

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

Gibt eine Stringliste zurück, die die Verkettung dieser Stringliste mit der Stringliste other ist.

Siehe auch append().

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

Hängt die angegebene Zeichenkette str an diese Stringliste an und gibt einen Verweis auf die Stringliste zurück.

Siehe auch append().

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

Dies ist eine überladene Funktion.

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

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

Dies ist eine überladene Funktion.

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

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

Kopieren des Zuweisungsoperators von QList<QString>. Weist die Liste der Zeichenketten von other dieser Zeichenkettenliste zu.

Nach dieser Operation sind other und *this gleich.

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

Dies ist eine überladene Funktion.

Verschiebe Zuweisungsoperator von QList<QString>. Verschiebt die Zeichenfolgenliste other in diese Zeichenfolgenliste.

Nach der Operation wird other leer sein.