QStringList Class

Dokumentation zu Mitgliedsfunktionen

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

Erstellt eine Kopie von ` other`.

Dieser Vorgang dauert eine konstante Zeit, da `QStringList` implizit gemeinsam genutzt wird. Dadurch ist die Rückgabe einer `QStringList` aus einer Funktion sehr schnell. Wird eine gemeinsam genutzte Instanz geändert, wird sie kopiert (Copy-on-Write), was lineare Zeit in Anspruch nimmt.

Siehe auch ` operator=()`.

QStringList::QStringList(const QString &str)

Erstellt eine Zeichenfolgenliste, die die angegebene Zeichenfolge „ str “ enthält. Längere Listen lassen sich ganz einfach wie folgt erstellen:

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

Siehe auch ` append()`.

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

Move-Konstrukte von QList<QString>.

Nach erfolgreicher 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 “ auf „ Qt::CaseSensitive “ gesetzt ist (Standard), wird beim Vergleich der Zeichenfolgen die Groß-/Kleinschreibung berücksichtigt; andernfalls erfolgt der Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.

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

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

Gibt „ true “ zurück, wenn die Liste die von „ str “ angezeigte Latin-1-Zeichenkette enthält; andernfalls wird „ false “ zurückgegeben.

Ist cs gleich Qt::CaseSensitive (Standard), wird beim Zeichenfolgenvergleich die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

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

[noexcept] bool QStringList::contains(QStringView 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 “ auf „ Qt::CaseSensitive “ gesetzt ist (Standard), wird beim Vergleich der Zeichenfolgen die Groß-/Kleinschreibung beachtet; andernfalls erfolgt der Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.

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

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

Die Verwendung von ` QLatin1StringMatcher ` kann bei der Suche in großen Listen und/oder in Listen mit langen Zeichenketten schneller sein (am besten lässt sich dies durch einen Benchmark-Test ermitteln).

Beispiel:

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

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch contains() und filter(const QStringMatcher &).

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

Gibt eine Liste aller Zeichenfolgen zurück, die die Teilzeichenfolge „ str “ enthalten.

Wenn „ cs “ auf „ Qt::CaseSensitive “ gesetzt ist (Standard), wird beim Vergleich der Zeichenfolgen die Groß-/Kleinschreibung berücksichtigt; andernfalls erfolgt der Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.

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

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

Dies entspricht

    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

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

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

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

Die Verwendung von ` QStringMatcher ` kann bei der Suche in großen Listen und/oder in Listen mit langen Zeichenketten schneller sein (am besten lässt sich dies durch einen Benchmark-Test feststellen).

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()` und ` filter(const QLatin1StringMatcher &)`.

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

Diese Funktion wurde in Qt 6.7 eingeführt.

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

Gibt die Indexposition des ersten Treffers von „ str “ in der Liste zurück, wobei die Suche ab der Indexposition „ from “ vorwärts erfolgt. Gibt -1 zurück, wenn kein Eintrag gefunden wurde.

Ist „ cs “ gleich „ Qt::CaseSensitive “ (Standard), wird beim Zeichenfolgenvergleich die Groß-/Kleinschreibung beachtet; andernfalls erfolgt der Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.

Siehe auch ` lastIndexOf()`.

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

Gibt die Indexposition der ersten exakten Übereinstimmung von ` re ` in der Liste zurück, wobei die Suche ab der Indexposition ` from` vorwärts erfolgt. Gibt -1 zurück, wenn kein Eintrag gefunden wurde.

Siehe auch lastIndexOf().

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

Fügt alle Zeichenfolgen der Zeichenfolgenliste zu einer einzigen Zeichenfolge zusammen, wobei die einzelnen Elemente durch das angegebene Trennzeichen separator (das eine leere Zeichenfolge sein kann) getrennt werden.

Siehe auch ` QString::split()`.

QString QStringList::join(QChar separator) const

QString QStringList::join(QLatin1StringView separator) const

QString QStringList::join(QStringView separator) const

Gibt die Indexposition des letzten Treffers von „ str “ in der Liste zurück, wobei die Suche rückwärts ab der Indexposition „ from “ erfolgt. Ist „ from “ gleich -1 (Standard), beginnt die Suche beim letzten Element. Gibt -1 zurück, wenn kein Element übereinstimmt.

Ist „ cs “ gleich „ Qt::CaseSensitive “ (Standard), wird bei dem Zeichenfolgenvergleich die Groß-/Kleinschreibung beachtet; andernfalls erfolgt der Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.

Siehe auch ` indexOf()`.

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

Gibt die Indexposition der letzten exakten Übereinstimmung von ` re ` in der Liste zurück, wobei die Suche rückwärts ab der Indexposition ` from` erfolgt. Ist ` from ` gleich -1 (Standardwert), beginnt die Suche beim letzten Element. 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 sein. 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 Liste von Zeichenketten zurück, in denen der Text „ before “ an allen Stellen, an denen der Text „ before “ vorkommt, durch den Text „ after “ ersetzt wurde.

Wenn „ cs “ auf „ Qt::CaseSensitive “ gesetzt ist (Standardeinstellung), wird beim Vergleich der Zeichenfolgen die Groß-/Kleinschreibung berücksichtigt; andernfalls erfolgt der Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.

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)

Ersetzt jedes Vorkommen des regulären Ausdrucks „ re “ in jeder Zeichenkette der Zeichenkettenliste durch „ after “. Gibt eine Referenz auf die Zeichenkettenliste zurück.

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, werden Vorkommen von \1, \2, ... in „ after “ durch die von der entsprechenden Erfassungsgruppe erfasste Zeichenfolge ersetzt.

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)

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)

Sortiert die Liste der Zeichenfolgen in aufsteigender Reihenfolge.

Wenn „ cs “ auf „ Qt::CaseSensitive “ gesetzt ist (Standardeinstellung), wird beim Vergleich der Zeichenfolgen die Groß-/Kleinschreibung berücksichtigt; andernfalls wird der Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung durchgeführt.

Die Sortierung erfolgt mithilfe des STL-Algorithmus `std::sort()`, der eine durchschnittliche lineare logarithmische Laufzeit aufweist, d. h. `O(n log n)`.

Wenn Sie Ihre Zeichenfolgen in einer beliebigen Reihenfolge sortieren möchten, sollten Sie die Klasse „ QMap “ in Betracht ziehen. Sie könnten beispielsweise eine ` QMap` <`QString`, ` QString`> verwenden, um eine sortierung ohne Berücksichtigung der Groß-/Kleinschreibung zu erstellen (z. B. mit den Schlüsseln als Kleinbuchstabenversionen der Zeichenfolgen und den Werten als Zeichenfolgen), oder eine ` QMap` <`int`, ` QString`>, um die Zeichenfolgen nach einem ganzzahligen Index zu sortieren.

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

Gibt eine Zeichenfolgenliste zurück, die aus der Verkettung dieser Zeichenfolgenliste mit der Zeichenfolgenliste „ other “ besteht.

Siehe auch „ append()“.

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

Fügt die angegebene Zeichenkette „ str “ an diese Zeichenkettensammlung an und gibt eine Referenz auf die Zeichenkettensammlung zurück.

Siehe auch ` append()`.

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

Fügt die Zeichenfolgenliste „ other “ an die Zeichenfolgenliste an und gibt eine Referenz auf die letztere Zeichenfolgenliste zurück.

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

Fügt die Zeichenfolgenliste „ other “ an die Zeichenfolgenliste an und gibt eine Referenz auf die letztere Zeichenfolgenliste zurück.

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

Kopiert den Zuweisungsoperator von QList<QString>. Weist dieser Zeichenfolgenliste die Liste der Zeichenfolgen aus other zu.

Nach der Operation sind other und *this identisch.

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

Zuweisungsoperator „move“ von QList<QString>. Verschiebt die Zeichenfolgenliste other in diese Zeichenfolgenliste.

Nach der Operation ist other leer.