QStringList Class

멤버 함수 문서

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

other 의 복사본을 생성합니다.

QStringList는 암시적으로 공유되므로 이 작업은 상수 시간 내에 완료됩니다. 이로 인해 함수에서 QStringList를 반환하는 작업이 매우 빠르게 수행됩니다. 공유된 인스턴스가 수정되면 복사(쓰기 시 복사)가 이루어지며, 이 작업에는 선형 시간이 소요됩니다.

operator=()도 참조하십시오 .

QStringList::QStringList(const QString &str)

주어진 문자열 str 을 포함하는 문자열 목록을 생성합니다. 더 긴 목록은 다음과 같이 쉽게 만들 수 있습니다:

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

append()도 참조하십시오 .

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

QList(<QString>)의 Move-constructs.

생성이 성공적으로 완료되면 other 는 비어 있게 됩니다.

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

목록에 문자열 “ str ”가 포함되어 있으면 “ true ”을 반환하고, 그렇지 않으면 “ false ”을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 문자열 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

indexOf(), lastIndexOf(), QString::contains()도 참조하십시오 .

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

목록에 str 로 해석된 Latin-1 문자열이 포함되어 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 문자열 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

indexOf(), lastIndexOf() 및 QString::contains()도 참조하십시오 .

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

목록에 문자열 str 이 포함되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

cs 가 Qt::CaseSensitive 인 경우(기본값), 문자열 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

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

matcher 에 의해 일치하는 모든 문자열의 목록을 반환합니다(즉, matcher.indexIn() 가 0 이상의 인덱스를 반환하는 문자열).

QLatin1StringMatcher 를 사용하면 대규모 리스트나 긴 문자열이 포함된 리스트에서 검색할 때 더 빠를 수 있습니다(이를 확인하는 가장 좋은 방법은 벤치마킹을 수행하는 것입니다).

예를 들어:

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

이 함수는 Qt 6.9에서 도입되었습니다.

contains() 및 filter(const QStringMatcher &)도 참조하십시오 .

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

str 라는 부분 문자열을 포함하는 모든 문자열의 목록을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 문자열 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

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

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

이는 다음과 동일합니다.

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

contains()도 참조하십시오 .

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

정규 표현식 re 에 일치하는 모든 문자열의 목록을 반환합니다.

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

matcher 에 의해 일치하는 모든 문자열의 목록을 반환합니다(즉, matcher.indexIn() 가 0 이상의 인덱스를 반환하는 문자열들).

QStringMatcher 를 사용하면 대규모 목록이나 긴 문자열이 포함된 목록에서 검색할 때 더 빠를 수 있습니다(이를 확인하는 가장 좋은 방법은 벤치마킹을 수행하는 것입니다).

예를 들어:

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

이 함수는 Qt 6.7에서 도입되었습니다.

contains() 및 filter(const QLatin1StringMatcher &)도 참조하십시오 .

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

이 함수는 Qt 6.7에서 도입되었습니다.

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

목록에서 str 와 처음 일치하는 항목의 인덱스 위치를 반환하며, 인덱스 위치 from 부터 앞으로 검색합니다. 일치하는 항목이 없으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 문자열 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

lastIndexOf()도 참조하십시오 .

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

목록에서 re 와 정확히 일치하는 첫 번째 항목의 인덱스 위치를 반환하며, 인덱스 위치 from 부터 앞으로 검색합니다. 일치하는 항목이 없으면 -1을 반환합니다.

lastIndexOf()도 참조하십시오 .

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

문자열 목록에 포함된 모든 문자열을 하나의 문자열로 결합하며, 각 요소는 지정된 구분자 separator (빈 문자열일 수도 있음)로 구분됩니다.

QString::split()도 참조하십시오 .

QString QStringList::join(QChar separator) const

QString QStringList::join(QLatin1StringView separator) const

QString QStringList::join(QStringView separator) const

from 인덱스 위치부터 역방향으로 검색하여, 목록에서 str 의 마지막 일치 항목의 인덱스 위치를 반환합니다. from 가 -1(기본값)인 경우, 검색은 마지막 항목에서 시작됩니다. 일치하는 항목이 없으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 문자열 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

indexOf()도 참조하십시오 .

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

from 에서 re 과 정확히 일치하는 마지막 항목의 인덱스 위치를 반환하며, 검색은 인덱스 위치 부터 역방향으로 진행됩니다. from 가 -1(기본값)인 경우, 검색은 마지막 항목부터 시작됩니다. 일치하는 항목이 없으면 -1을 반환합니다.

indexOf()도 참조하십시오 .

qsizetype QStringList::removeDuplicates()

이 함수는 목록에서 중복 항목을 제거합니다. 항목은 정렬되어 있을 필요가 없으며, 원래 순서가 유지됩니다.

제거된 항목의 개수를 반환합니다.

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

before 텍스트가 발견되는 모든 위치에서 해당 텍스트를 before 에서 after 로 대체한 문자열 목록을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 문자열 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

예를 들어:

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

QString::replace()도 참조하십시오 .

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

문자열 목록에 포함된 각 문자열에서 정규식 ` re`이 나타나는 모든 부분을 ` after`으로 대체합니다. 문자열 목록에 대한 참조를 반환합니다.

예를 들어:

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

캡처 그룹을 포함하는 정규 표현식의 경우, \1, \2, ...와 같은 부분이 after 내의 해당 캡처 그룹에 의해 캡처된 문자열로 대체됩니다.

예를 들어:

    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)

문자열 목록을 오름차순으로 정렬합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우, 문자열 비교는 대소문자를 구분하며, 그렇지 않은 경우 대소문자를 구분하지 않습니다.

정렬은 STL의 std::sort() 알고리즘을 사용하여 수행되며, 이 알고리즘의 평균 실행 시간은 선형-로그 시간, 즉 O(n log n)입니다.

문자열을 임의의 순서로 정렬하려면 QMap 클래스를 사용하는 것을 고려해 보십시오. 예를 들어, QMap<QString, QString>를 사용하여 대소문자를 구분하지 않는 정렬 순서를 만들 수 있습니다(예: 키는 문자열의 소문자 버전이고, 값은 문자열인 경우). 또는 QMap<int, QString>를 사용하여 특정 정수 인덱스 순서대로 문자열을 정렬할 수 있습니다.

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

이 문자열 목록과 ‘ other ’ 문자열 목록을 연결한 문자열 목록을 반환합니다.

append()도 참조하십시오 .

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

지정된 문자열 str 을 이 문자열 목록에 추가하고, 해당 문자열 목록에 대한 참조를 반환합니다.

append()도 참조하십시오 .

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

other 의 문자열 목록을 문자열 목록에 추가하고, 후자의 문자열 목록에 대한 참조를 반환합니다.

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

other 의 문자열 목록을 문자열 목록에 추가하고, 후자의 문자열 목록에 대한 참조를 반환합니다.

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

QList<QString>에서 할당 연산자를 복사합니다. other 에 있는 문자열 목록을 이 문자열 목록에 할당합니다.

연산이 완료된 후, other 과 *this 은 서로 같아집니다.

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

QList 에서 할당 연산자를 이동 <QString>. other 에 있는 문자열 목록을 이 문자열 목록으로 이동합니다.

연산이 완료되면 other 는 비어 있게 됩니다.