QString Class

멤버 함수 설명서

[constexpr noexcept] QString::QString()

빈 문자열을 생성합니다. 빈 문자열은 빈 상태로 간주됩니다.

isEmpty(), isNull() 및 Distinction Between Null and Empty Strings도 참조하십시오 .

QString::QString(QChar ch)

ch 문자를 포함하는, 길이가 1인 문자열을 생성합니다.

QString::QString(QLatin1StringView str)

str 에서 인식된 Latin-1 문자열의 복사본을 생성합니다.

fromLatin1()도 참조하십시오 .

[explicit, since 6.8] QString::QString(QStringView sv)

스트링 뷰의 데이터로 초기화된 문자열을 생성합니다.

sv 가 null인 경우에만 QString이 null이 됩니다.

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

fromUtf16()도 참조하십시오 .

QString::QString(const QByteArray &ba)

ba 바이트 배열로 초기화된 문자열을 생성합니다. 주어진 바이트 배열은 fromUtf8() 함수를 사용하여 유니코드로 변환됩니다.

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_ASCII 를 정의하여 이 생성자를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 QObject::tr()를 통해 처리되도록 보장하려는 경우 이 방법이 유용할 수 있습니다.

fromLatin1(), fromLocal8Bit(), fromUtf8()도 참조하십시오 .

QString::QString(const char *str)

8비트 문자열 str 로 초기화된 문자열을 생성합니다. 주어진 const char 포인터는 fromUtf8() 함수를 사용하여 유니코드로 변환됩니다.

응용 프로그램을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `를 정의하면 이 생성자를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`를 반드시 거치도록 보장하고자 할 때 이 방법이 유용할 수 있습니다.

fromLatin1(), fromLocal8Bit(), fromUtf8()도 참조하십시오 .

[since 6.1] QString::QString(const char8_t *str)

UTF-8 문자열 ` str`으로 초기화된 문자열을 생성합니다. 지정된 `const char8_t` 포인터는 ` fromUtf8()` 함수를 사용하여 유니코드로 변환됩니다.

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

fromLatin1(), fromLocal8Bit() 및 fromUtf8()도 참조하십시오 .

[explicit] QString::QString(const QChar *unicode, qsizetype size = -1)

QChar 배열 unicode 의 첫 번째 size 개 문자로 초기화된 문자열을 생성합니다.

unicode 가 0인 경우, 빈 문자열이 생성됩니다.

size 가 음수인 경우, unicode 는 '\0'로 끝나는 배열을 가리키는 것으로 간주되며 그 길이는 동적으로 결정됩니다. 끝을 나타내는 null 문자는 문자열의 일부로 간주되지 않습니다.

QString은 문자열 데이터의 심층 복사본을 만듭니다. 유니코드 데이터는 있는 그대로 복사되며, 바이트 순서 표시(Byte Order Mark)가 있는 경우 그대로 보존됩니다.

fromRawData()도 참조하십시오 .

QString::QString(qsizetype size, QChar ch)

지정된 size 를 문자열로 생성하며, 모든 문자를 ch 로 설정합니다.

fill()도 참조하십시오 .

[noexcept] QString::QString(const QString &other)

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

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

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

[noexcept default] QString::QString(QString &&other)

QString 인스턴스를 이동 생성하여, 해당 인스턴스가 ` other `가 가리키던 것과 동일한 객체를 가리키게 합니다.

[noexcept] QString::~QString()

문자열을 삭제합니다.

QString &QString::append(const QString &str)

이 문자열의 끝에 “ str ”라는 문자열을 추가합니다.

예시:

QString x = "free";
QString y = "dom";

x.append(y);
// x == "freedom"

이는 insert() 함수를 사용하는 것과 동일합니다:

x.insert(x.size(), y);

append() 함수는 일반적으로 매우 빠릅니다(상수 시간). 이는 QString 가 문자열 데이터의 끝에 추가 공간을 미리 할당해 두기 때문에, 매번 문자열 전체를 재할당하지 않고도 길이를 늘릴 수 있기 때문입니다.

operator+=(), prepend() 및 insert()도 참조하십시오 .

QString &QString::append(QChar ch)

이 문자열에 ‘ ch ’ 문자를 추가합니다.

QString &QString::append(QLatin1StringView str)

str 함수가 인식한 Latin-1 문자열을 이 문자열 뒤에 추가합니다.

[since 6.0] QString &QString::append(QStringView v)

지정된 문자열 뷰 ` v `를 이 문자열에 추가하고 그 결과를 반환합니다.

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

[since 6.5] QString &QString::append(QUtf8StringView str)

UTF-8 문자열 뷰 ` str `를 이 문자열에 추가합니다.

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

QString &QString::append(const QByteArray &ba)

이 문자열에 바이트 배열 ` ba `을 추가합니다. 주어진 바이트 배열은 ` fromUtf8()` 함수를 사용하여 유니코드로 변환됩니다.

애플리케이션을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `을 정의하여 이 함수를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`을 반드시 거치도록 보장하고자 할 때 유용할 수 있습니다.

QString &QString::append(const char *str)

이 문자열에 “ str ” 문자열을 추가합니다. 지정된 const char 포인터는 fromUtf8() 함수를 사용하여 유니코드로 변환됩니다.

응용 프로그램을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `를 정의하여 이 함수를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`를 반드시 거치도록 보장하고자 할 때 유용할 수 있습니다.

QString &QString::append(const QChar *str, qsizetype len)

QChar 배열 str 에 포함된 ‘ len ’ 문자를 이 문자열에 추가합니다.

template <typename... Args> QString QString::arg(Args &&... args) const

이 문자열에서 %N 가 나타나는 부분을 args 의 해당 인수로 대체합니다. 인수는 위치에 따라 구분되지 않습니다. 즉, args 의 첫 번째 인수는 %N 를 가장 낮은 N (모두)로 대체하고, args 의 두 번째 인수는 %N 를 그 다음으로 낮은 N 로 대체하는 식입니다.

Args QAnyStringView 로 암시적으로 변환되는 모든 것으로 구성될 수 있습니다.

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

template <typename T> requires if_string_like<T> QString QString::arg(const T &a, int fieldWidth = 0, QChar fillChar = u' ') const

이 문자열의 복사본을 반환하며, 번호가 가장 낮은 자리 표시자를 string a 로 대체합니다. 즉, %1, %2, ..., %99 와 같습니다.

fieldWidth a 가 차지해야 하는 최소 공간을 지정합니다. 가 보다 적은 공간을 필요로 하는 경우, 문자로 채워져 가 되도록 합니다. 양수인 는 텍스트를 오른쪽 정렬로 만듭니다. 음수인 는 텍스트를 왼쪽 정렬로 만듭니다. a fieldWidth fillChar fieldWidth fieldWidth fieldWidth

이 예제는 파일 목록을 처리하는 동안 진행 상황을 보고하기 위해 status 문자열을 생성하는 방법을 보여줍니다:

int i;                // current file's number
int total;            // number of files to process
QStringView fileName; // current file's name

QString status = QString("Processing file %1 of %2: %3")
                .arg(i).arg(total).arg(fileName);

먼저, ` arg(i) `는 ` %1`을 대체합니다. 그런 다음 ` arg(total) `는 ` %2`을 대체합니다. 마지막으로, ` arg(fileName) `는 ` %3`을 대체합니다.

asprintf() 대신 arg()를 사용하는 한 가지 장점은, 애플리케이션의 문자열이 다른 언어로 번역될 경우 번호가 매겨진 자리 표시자의 순서가 바뀔 수 있지만, 각 arg()는 어디에 나타나든 상관없이 번호가 가장 낮은 미대체된 자리 표시자를 계속 대체한다는 점입니다. 또한, 문자열 내에 자리 표시자 %i 가 두 번 이상 나타나는 경우, arg()는 이 자리 표시자들을 모두 대체합니다.

대체되지 않은 자리 표시자가 남아 있지 않으면 경고 메시지가 출력되고 결과는 정의되지 않습니다. 자리 표시자 번호는 1에서 99 사이여야 합니다.

template <typename T> requires if_integral_non_char<T> QString QString::arg(T a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

a 인수는 기수 base 로 표현되며, 기본값은 10이고 2에서 36 사이의 값이어야 합니다. 10 이외의 기수를 사용하는 경우, a 은 부호 없는 정수로 처리됩니다.

fieldWidth a 가 문자로 채워져 확장되는 최소 공간의 크기를 지정합니다. 양수 값을 지정하면 텍스트가 오른쪽 정렬되고, 음수 값을 지정하면 텍스트가 왼쪽 정렬됩니다. fillChar

'%' 뒤에 'L'이 올 수 있으며, 이 경우 해당 시퀀스는 a 의 현지화된 표현으로 대체됩니다. 변환에는 QLocale::setDefault()로 설정된 기본 로케일이 사용됩니다. 기본 로케일이 지정되지 않은 경우 시스템 로케일이 사용됩니다. base 가 10이 아닌 경우 'L' 플래그는 무시됩니다.

QString str;
str = QString("Decimal 63 is %1 in hexadecimal")
        .arg(63, 0, 16);
// str == "Decimal 63 is 3f in hexadecimal"

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString("%1 %L2 %L3")
        .arg(12345)
        .arg(12345)
        .arg(12345, 0, 16);
// str == "12345 12,345 3039"

Number formats도 참조하십시오 .

template <typename T> requires if_floating_point<T> QString QString::arg(T a, int fieldWidth = 0, char format = 'g', int precision = -1, QChar fillChar = u' ') const

a 인수는 지정된 format 및 precision 에 따라 서식이 지정됩니다. 자세한 내용은 Floating-point Formats 을 참조하십시오.

fieldWidth a 가 문자로 채워지며, 이를 위해 패딩되는 최소 공간의 크기를 지정합니다. 양수 값을 지정하면 텍스트가 오른쪽 정렬되고, 음수 값을 지정하면 왼쪽 정렬됩니다. fillChar

double d = 12.34;
QString str = QString("delta: %1").arg(d, 0, 'E', 3);
// str == "delta: 1.234E+01"

QLocale::toString(), QLocale::FloatingPointPrecisionOption 및 Number formats도 참조하십시오 .

[static] QString QString::asprintf(const char *cformat, ...)

cformat 형식 문자열과 임의의 인자 목록을 사용하여 서식이 지정된 문자열을 안전하게 생성합니다.

이 포맷 문자열은 표준 C++ 라이브러리의 printf()에서 제공하는 변환 지정자, 길이 수정자 및 플래그를 지원합니다. cformat 문자열과 %s 인수는 UTF-8로 인코딩되어야 합니다.

QString result;
QTextStream(&result) << "pi = " << 3.14;
// result == "pi = 3.14"

translations 의 경우, 특히 문자열에 두 개 이상의 이스케이프 시퀀스가 포함된 경우에는 대신 arg() 함수를 사용하는 것을 고려해야 합니다. 이를 통해 번역자가 대체 순서를 제어할 수 있습니다.

arg()도 참조하십시오 .

[since 6.6] QString &QString::assign(QAnyStringView v)

이 문자열의 내용을 v 의 복사본으로 대체하고, 이 문자열에 대한 참조를 반환합니다.

이 문자열의 크기는 ` v`의 크기와 동일하며, ` v.toString()`을 통해 변환된 것처럼 UTF-16으로 변환됩니다. 그러나 ` QAnyStringView::toString()`과 달리, 이 함수는 예상 크기가 이 문자열의 용량을 초과하거나 이 문자열이 공유된 경우에만 메모리를 할당합니다.

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

QAnyStringView::toString()도 참조하십시오 .

[since 6.6] template <typename InputIterator> requires if_compatible_iterator<InputIterator> QString &QString::assign(InputIterator first, InputIterator last)

이 문자열의 내용을 반복자 범위 [first, last) 내 요소들의 복사본으로 대체하고, 이 문자열에 대한 참조를 반환합니다.

이 문자열의 크기는 [first, last) 범위에 있는 요소들의 디코딩된 길이와 같게 되며, 이 함수는 입력 문자 집합을 UTF-16으로 투명하게 재인코딩하기 때문에 이 길이는 범위 자체의 길이와 같을 필요는 없습니다.

이 함수는 범위의 요소 수(또는 UTF-16으로 인코딩되지 않은 입력의 경우, 결과 문자열의 최대 가능한 크기)가 이 문자열의 용량을 초과하거나, 이 문자열이 공유되는 경우에만 메모리를 할당합니다.

제약 조건

InputIterator 가 LegacyInputIterator의 요구 사항을 충족하고, InputIterator 의 value_type 가 다음 문자 유형 중 하나일 경우에만 오버로드 해결에 참여합니다:

• QChar
• QLatin1Char
• char
• unsigned char
• signed char
• char8_t
• char16_t
• (Windows와 같이 16비트 유형인 플랫폼의 경우) wchar_t
• char32_t

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

[since 6.6] QString &QString::assign(qsizetype n, QChar c)

이 문자열의 내용을 c 의 n 개 복사본으로 대체하고, 이 문자열에 대한 참조를 반환합니다.

이 문자열의 크기는 n 와 같아지며, 이 값은 0 이상이어야 합니다.

n 가 이 문자열의 용량을 초과하거나 이 문자열이 공유된 경우에만 이 함수가 메모리를 할당합니다.

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

fill()도 참조하십시오 .

const QChar QString::at(qsizetype position) const

문자열에서 지정된 인덱스 position 에 있는 문자를 반환합니다.

position 는 문자열 내에서 유효한 인덱스 위치여야 합니다(즉, 0 <= position < size()).

operator[]()도 참조하십시오 .

QChar &QString::back()

문자열의 마지막 문자에 대한 참조를 반환합니다. ` operator[](size() - 1)`와 동일합니다.

이 함수는 STL 호환성을 위해 제공됩니다.

front(), at(), operator[]()도 참조하십시오 .

QChar QString::back() const

문자열의 마지막 문자를 반환합니다. ` at(size() - 1)`와 동일합니다.

이 함수는 STL 호환성을 위해 제공됩니다.

front(), at(), operator[]()도 참조하십시오 .

QString::iterator QString::begin()

문자열의 첫 번째 문자를 가리키는 STL 스타일의 이터레이터를 반환합니다.

참조: ` constBegin()` 및 ` end()`.

QString::const_iterator QString::begin() const

qsizetype QString::capacity() const

재할당을 유발하지 않고 문자열에 저장할 수 있는 최대 문자 수를 반환합니다.

이 함수의 유일한 목적은 ` QString`의 메모리 사용량을 미세 조정할 수 있는 수단을 제공하는 것입니다. 일반적으로 이 함수를 호출할 일은 거의 없습니다. 문자열에 포함된 문자 수를 알고 싶다면 ` size()`를 호출하십시오.

reserve() 및 squeeze()도 참조하십시오 .

QString::const_iterator QString::cbegin() const

문자열의 첫 번째 문자를 가리키는 const STL 스타일의 반복자를 반환합니다.

참조: begin() 및 cend().

QString::const_iterator QString::cend() const

문자열의 마지막 문자가 끝난 바로 다음 위치를 가리키는 const STL 스타일의 이터레이터를 반환합니다.

참조: ` cbegin()` 및 ` end()`.

void QString::chop(qsizetype n)

문자열의 끝에서 ‘ n ’ 문자들을 제거합니다.

n 가 size() 이상인 경우, 결과는 빈 문자열이 됩니다. n 가 음수인 경우, 0을 전달한 것과 동일합니다.

예시:

QString str("LOGOUT\r\n");
str.chop(2);
// str == "LOGOUT"

문자열의 시작 부분에서 문자를 제거하려면 대신 remove()을 사용하십시오.

truncate(), resize(), remove(), QStringView::chop()도 참조하십시오 .

이 문자열의 가장 왼쪽에 위치한 size() - len 개의 문자를 포함하는 문자열을 반환합니다.

endsWith(), first(), last(), sliced(), chop(), truncate(), slice()도 참조하십시오 .

void QString::clear()

문자열의 내용을 지우고 null로 만듭니다.

resize() 및 isNull()도 참조하십시오 .

[static noexcept] int QString::compare(const QString &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

s1 라는 문자열과 s2 라는 문자열을 비교하여, s1 가 s2 보다 작으면 음의 정수를, 가 s2 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

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

대소문자를 구분하는 비교는 문자 자체의 숫자형 유니코드 값만을 기반으로 하여 매우 빠르지만, 사람이 기대하는 방식과는 다릅니다. localeAwareCompare()를 사용하여 사용자에게 표시되는 문자열을 정렬하는 경우를 생각해 보십시오.

int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0
int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0
int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0

operator==(), operator<(), operator>(), Comparing Strings도 참조하십시오 .

[noexcept] int QString::compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

cs 설정을 사용하여, 이 값과 ch 간의 비교를 수행합니다.

[noexcept] int QString::compare(QLatin1StringView other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

compare(*this, other, cs)와 동일합니다.

[noexcept] int QString::compare(QStringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

cs 설정을 사용하여, 이 값과 s 값을 비교합니다.

[noexcept] int QString::compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열과 other 문자열을 사전 순으로 비교하여, 이 문자열이 other 보다 작으면 음의 정수를, other 보다 크면 양의 정수를, 둘이 같으면 0을 반환합니다.

compare(*this, other, cs)와 동일합니다.

[static noexcept] int QString::compare(QLatin1StringView s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

cs 의 대소문자 구분 설정을 사용하여 s1 과 s2 을 비교합니다.

[static noexcept] int QString::compare(QStringView s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

[static noexcept] int QString::compare(const QString &s1, QLatin1StringView s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

cs 설정에 따라 대소문자 구별 여부를 고려하여 s1 와 s2 를 비교합니다.

[static noexcept] int QString::compare(const QString &s1, QStringView s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

QString::const_iterator QString::constBegin() const

문자열의 첫 번째 문자를 가리키는 const STL 스타일 이터레이터를 반환합니다.

참조: ` begin()` 및 ` constEnd()`.

const QChar *QString::constData() const

QString 에 저장된 데이터에 대한 포인터를 반환합니다. 이 포인터를 사용하여 문자열을 구성하는 각 문자에 접근할 수 있습니다.

문자가 수정되지 않는 한 이 포인터는 유효함을 유지합니다.

data(), operator[]() 및 fromRawData()도 참조하십시오 .

QString::const_iterator QString::constEnd() const

문자열의 마지막 문자가 끝난 바로 다음 위치를 가리키는 const STL 스타일의 이터레이터를 반환합니다.

참조: ` constBegin()` 및 ` end()`.

bool QString::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

정규 표현식 re 이 이 문자열의 어느 곳에서든 일치하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

일치하는 부분이 있고 rmatch 가 nullptr 가 아닌 경우, 일치 결과를 rmatch 가 가리키는 QRegularExpressionMatch 객체에 기록합니다.

QRegularExpression::match()도 참조하십시오 .

bool QString::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

예:

QString str = "Peter Pan";
str.contains("peter", Qt::CaseInsensitive);    // returns true

indexOf() 및 count()도 참조하십시오 .

bool QString::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

bool QString::contains(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

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

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

indexOf() 및 count()도 참조하십시오 .

qsizetype QString::count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 “ str ”이라는 문자열이 (중복될 수 있는) 몇 번 나타나는지 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

contains() 및 indexOf()도 참조하십시오 .

qsizetype QString::count(const QRegularExpression &re) const

re 정규 표현식이 문자열 내에서 일치하는 횟수를 반환합니다.

역사적인 이유로 인해 이 함수는 중복된 일치 항목도 계산하므로, 아래 예제에서는 "ana" 또는 "ama"가 4번 나타납니다:

QString str = "banana and panama";
str.count(QRegularExpression("a[nm]a"));    // returns 4

이러한 동작은 QRegularExpressionMatchIterator 를 사용하여 문자열 내의 일치 항목을 단순히 반복 처리하는 것과는 다릅니다.

QRegularExpression::globalMatch()도 참조하십시오 .

qsizetype QString::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열 내에서 ch 문자가 나타나는 횟수를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

contains() 및 indexOf()도 참조하십시오 .

[since 6.0] qsizetype QString::count(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 내에서 문자열 뷰 str 가 (중복될 수 있는) 몇 번 나타나는지 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

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

contains() 및 indexOf()도 참조하십시오 .

QString::const_reverse_iterator QString::crbegin() const

문자열의 첫 번째 문자를 역순으로 가리키는 const STL 스타일의 역방향 이터레이터를 반환합니다.

참조: ` begin()`, ` rbegin()`, ` rend()`.

QString::const_reverse_iterator QString::crend() const

문자열의 마지막 문자를 지나 바로 다음 위치에 있는, 역순으로 정렬된 상수 STL 스타일 역방향 이터레이터를 반환합니다.

참조: end(), rend(), rbegin().

QChar *QString::data()

QString 에 저장된 데이터에 대한 포인터를 반환합니다. 이 포인터를 사용하여 문자열을 구성하는 각 문자에 접근하고 수정할 수 있습니다.

constData() 및 unicode()와 달리, 반환되는 데이터는 항상 '\0'로 끝납니다.

예시:

QString str = "Hello world";
QChar*data = str.data();
while (!data->isNull()) {
    qDebug() << data->unicode();
   ++data;
}

포인터는 문자열이 다른 방법으로 수정되지 않는 한 유효하다는 점에 유의하십시오. 읽기 전용 액세스의 경우, constData()은 딥 복사가 발생하지 않기 때문에 더 빠릅니다.

constData() 및 operator[]()도 참조하십시오 .

const QChar *QString::data() const

fromRawData()도 참조하십시오 .

void QString::detach()

이 문자열의 데이터가 더 이상 다른 인스턴스와 공유되지 않도록 합니다.

QString::iterator QString::end()

문자열의 마지막 문자가 끝난 바로 다음 위치를 가리키는 STL 스타일의 이터레이터를 반환합니다.

참조: ` begin()` 및 ` constEnd()`.

QString::const_iterator QString::end() const

bool QString::endsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열이 s 로 끝나는 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

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

QString str = "Bananas";
str.endsWith("anas");         // returns true
str.endsWith("pple");         // returns false

startsWith()도 참조하십시오 .

bool QString::endsWith(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

문자열이 c 로 끝나는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

bool QString::endsWith(QLatin1StringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

문자열이 “ str ”으로 끝나는 경우 “ true ”을 반환하고, 그렇지 않은 경우 “ false ”을 반환합니다.

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

startsWith()도 참조하십시오 .

[since 6.1] QString::iterator QString::erase(QString::const_iterator first, QString::const_iterator last)

문자열에서 [ first, last ) 범위에 속하는 문자들을 제거합니다. 마지막으로 삭제된 문자 바로 다음의 문자로 이동하는 이터레이터를 반환합니다(즉, 삭제 전 last 가 가리키던 문자).

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

[since 6.5] QString::iterator QString::erase(QString::const_iterator it)

it 로 표시된 문자를 문자열에서 제거합니다. 삭제된 문자 바로 뒤에 오는 문자로 이동하는 이터레이터를 반환합니다.

QString c = "abcdefg";
auto it = c.erase(c.cbegin()); // c is now "bcdefg"; "it" points to "b"

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

QString &QString::fill(QChar ch, qsizetype size = -1)

문자열의 모든 문자를 ch 문자로 설정합니다. size 가 -1(기본값)과 다를 경우, 문자열은 사전에 size 크기로 조정됩니다.

예:

QString str = "Berlin";
str.fill('z');
// str == "zzzzzz"

str.fill('A', 2);
// str == "AA"

resize()도 참조하십시오 .

이 문자열의 처음 n 자를 포함하는 문자열을 반환합니다(즉, 이 문자열의 시작부터 인덱스 위치 n 에 있는 요소 직전까지를 포함하되, 해당 요소는 제외합니다).

QString x = "Pineapple";
QString y = x.first(4);      // y == "Pine"

이 함수들은 Qt 6.0에서 도입되었습니다.

last(), sliced(), startsWith(), chopped(), chop(), truncate() 및 slice()도 참조하십시오 .

[static] QString QString::fromCFString(CFStringRef string)

string 의 복사본을 포함하는 새로운 QString 객체를 생성합니다.

[static, since 6.6] QString QString::fromEcmaString(emscripten::val jsString)

ECMAScript 문자열 ` jsString `을 ` QString`으로 변환합니다. 전달된 매개변수가 문자열이 아닌 경우 동작이 정의되지 않습니다.

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

toEcmaString()도 참조하십시오 .

[static] QString QString::fromLatin1(const char *str, qsizetype size)

str 라는 Latin-1 문자열의 처음 size 자까지로 초기화된 QString 객체를 반환합니다.

size 가 -1 인 경우, 대신 strlen(str) 가 사용됩니다.

toLatin1(), fromUtf8(), fromLocal8Bit()도 참조하십시오 .

[static, since 6.0] QString QString::fromLatin1(QByteArrayView str)

Latin-1 문자열 str 으로 초기화된 QString 객체를 반환합니다.

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

[static] QString QString::fromLatin1(const QByteArray &str)

Latin-1 문자열 str 으로 초기화된 QString 을 반환합니다.

[static] QString QString::fromLocal8Bit(const char *str, qsizetype size)

8비트 문자열 ` str`의 처음 ` size `개 문자로 초기화된 ` QString ` 객체를 반환합니다.

size 가 -1 인 경우, 대신 strlen(str) 가 사용됩니다.

유닉스 시스템에서 이는 fromUtf8()와 동일합니다. 애플 시스템에서 이 함수는 NSString.defaultCStringEncoding이나 CFStringGetSystemEncoding() 을 고려하지 않는다는 점에 유의하십시오. 이러한 함수는 일반적으로 구식인 "Western (Mac OS Roman)" 인코딩을 반환하는데, 이는 최신 애플 운영 체제에서는 사용해서는 안 됩니다. Windows에서는 시스템의 현재 코드 페이지가 사용됩니다.

toLocal8Bit(), fromLatin1(), fromUtf8()도 참조하십시오 .

[static, since 6.0] QString QString::fromLocal8Bit(QByteArrayView str)

str 라는 8비트 문자열로 초기화된 ` QString `를 반환합니다.

유닉스 시스템에서 이는 fromUtf8()과 동일합니다. Apple 시스템에서는 이 함수가 NSString.defaultCStringEncoding이나 CFStringGetSystemEncoding() 을 고려하지 않는다는 점에 유의하십시오. 이러한 함수들은 일반적으로 구식 "Western (Mac OS Roman)" 인코딩을 반환하는데, 이는 최신 Apple 운영 체제에서는 사용해서는 안 되는 인코딩입니다. Windows에서는 시스템의 현재 코드 페이지가 사용됩니다.

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

[static] QString QString::fromLocal8Bit(const QByteArray &str)

str 라는 8비트 문자열로 초기화된 ` QString `를 반환합니다.

유닉스 시스템에서 이 함수는 fromUtf8()과 동일하게 작동합니다. 단, 애플 시스템에서는 이 함수가 NSString.defaultCStringEncoding이나 CFStringGetSystemEncoding() 을 고려하지 않는다는 점에 유의하십시오. 이 함수들은 일반적으로 구식인 "Western (Mac OS Roman)" 인코딩을 반환하는데, 이는 최신 애플 운영 체제에서는 사용해서는 안 되는 인코딩입니다. Windows에서는 시스템의 현재 코드 페이지가 사용됩니다.

[static] QString QString::fromNSString(const NSString *string)

string 의 NSString 사본을 포함하는 새로운 QString 객체를 생성합니다.

[static, since 6.10] QString QString::fromRawData(const char16_t *unicode, qsizetype size)

배열 unicode 의 처음 size 개 유니코드 문자를 사용하는 QString 객체를 생성합니다. unicode 의 데이터는 복사되지 않습니다. 호출자는 QString (또는 그 수정되지 않은 복사본)이 존재하는 한 unicode 가 삭제되거나 수정되지 않을 것임을 보장할 수 있어야 합니다.

QString 또는 그 복사본을 수정하려는 모든 시도는 데이터의 심층 복사(deep copy)를 생성하게 되어, 원시 데이터가 수정되지 않도록 보장합니다.

다음은 데이터를 QString 로 복사할 필요 없이 메모리 내의 원시 데이터에 대해 QRegularExpression 를 사용할 수 있는 예시입니다:

QRegularExpression pattern("\u00A4");
static const char16_t unicode[] = {
        0x005A, 0x007F, 0x00A4, 0x0060,
        0x1009, 0x0020, 0x0020};

QString str = QString::fromRawData(unicode, std::size(unicode));
if (str.contains(pattern)) {
    // ...
}

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

fromUtf16(), setRawData(), data(), constData(), nullTerminate() 및 nullTerminated()도 참조하십시오 .

[static] QString QString::fromRawData(const QChar *unicode, qsizetype size)

[static] QString QString::fromStdString(const std::string &str)

str 문자열의 복사본을 반환합니다. 주어진 문자열은 UTF-8로 인코딩된 것으로 간주되며, fromUtf8() 함수를 사용하여 QString 로 변환됩니다.

fromLatin1(), fromLocal8Bit(), fromUtf8() 및 QByteArray::fromStdString()도 참조하십시오 .

[static] QString QString::fromStdU16String(const std::u16string &str)

str 문자열의 복사본을 반환합니다. 주어진 문자열은 UTF-16으로 인코딩된 것으로 간주되며, fromUtf16() 함수를 사용하여 QString 로 변환됩니다.

fromUtf16(), fromStdWString(), fromStdU32String()도 참조하십시오 .

[static] QString QString::fromStdU32String(const std::u32string &str)

str 문자열의 복사본을 반환합니다. 주어진 문자열은 UTF-32로 인코딩된 것으로 간주되며, fromUcs4() 함수를 사용하여 QString 로 변환됩니다.

fromUcs4(), fromStdWString(), fromStdU16String()도 참조하십시오 .

[static] QString QString::fromStdWString(const std::wstring &str)

str 문자열의 복사본을 반환합니다. wchar_t의 크기가 2바이트인 경우(예: Windows) 주어진 문자열은 utf16으로 인코딩된 것으로 간주되며, wchar_t의 크기가 4바이트인 경우(대부분의 Unix 시스템) ucs4로 인코딩된 것으로 간주됩니다.

fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4(), fromStdU16String() 및 fromStdU32String()도 참조하십시오 .

[static] QString QString::fromUcs4(const char32_t *unicode, qsizetype size = -1)

UTF-32로 인코딩된 유니코드 문자열 unicode 의 처음 size 자 문자로 초기화된 QString 객체를 반환합니다.

size 가 -1(기본값)인 경우, unicode 는 '\0'로 끝나야 합니다.

toUcs4(), fromUtf16(), utf16(), setUtf16(), fromWCharArray(), fromStdU32String()도 참조하십시오 .

[static] QString QString::fromUtf8(const char *str, qsizetype size)

UTF-8 문자열 str 의 첫 size 바이트로 초기화된 QString 객체를 반환합니다.

size 가 -1 인 경우, 대신 strlen(str) 가 사용됩니다.

UTF-8은 유니코드 코덱이며, QString 와 같은 유니코드 문자열의 모든 문자를 표현할 수 있습니다. 그러나 UTF-8에서는 유효하지 않은 시퀀스가 발생할 수 있으며, 이러한 시퀀스가 발견되면 하나 이상의 "대체 문자"로 대체되거나 생략됩니다. 여기에는 비유니코드 시퀀스, 비문자, 과도하게 긴 시퀀스 또는 UTF-8로 인코딩된 대리 코드포인트가 포함됩니다.

이 함수는 들어오는 데이터 내의 모든 UTF-8 문자가 올바르게 종료되어 있는 한, 들어오는 데이터를 증분 방식으로 처리하는 데 사용할 수 있습니다. 문자열 끝에 종료되지 않은 문자가 있으면 대체되거나 생략됩니다. 상태 기반 디코딩을 수행하려면 QStringDecoder 를 사용하십시오.

toUtf8(), fromLatin1(), fromLocal8Bit()도 참조하십시오 .

[static, since 6.0] QString QString::fromUtf8(QByteArrayView str)

UTF-8 문자열 ` str`으로 초기화된 ` QString `을 반환합니다.

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

[static] QString QString::fromUtf8(const QByteArray &str)

UTF-8 문자열 str 으로 초기화된 QString 를 반환합니다.

[static, since 6.1] QString QString::fromUtf8(const char8_t *str)

이 오버로드는 C++20 모드로 컴파일할 때만 사용할 수 있습니다.

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

[static, since 6.0] QString QString::fromUtf8(const char8_t *str, qsizetype size)

이 오버로드는 C++20 모드로 컴파일할 때만 사용할 수 있습니다.

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

[static] QString QString::fromUtf16(const char16_t *unicode, qsizetype size = -1)

Unicode 문자열 unicode (ISO-10646-UTF-16 인코딩)의 처음 size 자까지로 초기화된 QString 객체를 반환합니다.

size 가 -1(기본값)인 경우, unicode 는 '\0'로 끝나야 합니다.

이 함수는 바이트 순서 표시(BOM)가 있는지 확인합니다. BOM이 없는 경우 호스트 바이트 순서가 사용된 것으로 간주합니다.

이 함수는 다른 유니코드 변환에 비해 속도가 느립니다. 가능하면 QString(const QChar *, qsizetype) 또는 QString(const QChar *)를 사용하십시오.

QString 유니코드 데이터의 딥 복사본을 만듭니다.

utf16(), setUtf16() 및 fromStdU16String()도 참조하십시오 .

[static] QString QString::fromWCharArray(const wchar_t *string, qsizetype size = -1)

string 가 가리키는 wchar_t 배열의 처음 size 코드 유닛을 읽어와 유니코드로 변환한 후, 그 결과를 QString 로 반환합니다. wchar_t 에서 사용하는 인코딩은 타입의 크기가 4바이트인 경우 UTF-32로, 2바이트인 경우 UTF-16으로 간주됩니다.

size 가 -1(기본값)인 경우, string 는 반드시 '\0'로 끝나야 합니다.

fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4() 및 fromStdWString()도 참조하십시오 .

QChar &QString::front()

문자열의 첫 번째 문자에 대한 참조를 반환합니다. ` operator[](0)`와 동일합니다.

이 함수는 STL 호환성을 위해 제공됩니다.

back(), at(), operator[]()도 참조하십시오 .

QChar QString::front() const

문자열의 첫 번째 문자를 반환합니다. ` at(0)`와 동일합니다.

이 함수는 STL 호환성을 위해 제공됩니다.

참조: back(), at(), operator[]().

qsizetype QString::indexOf(QLatin1StringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 str 로 해석된 Latin-1 문자열이 처음 나타나는 인덱스 위치를 반환하며, 검색은 인덱스 위치 from 부터 앞으로 진행됩니다. str 가 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

예시:

QString x = "sticky question";
QString y = "sti";
x.indexOf(y);               // returns 0
x.indexOf(y, 1);            // returns 10
x.indexOf(y, 10);           // returns 10
x.indexOf(y, 11);           // returns -1

from 가 -1이면 검색은 마지막 문자로부터 시작되며, -2이면 두 번째 마지막 문자로부터 시작하는 식입니다.

lastIndexOf(), contains(), count()도 참조하십시오 .

qsizetype QString::indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const

인덱스 위치 from 부터 앞으로 검색하여, 문자열 내에서 정규식 re 의 첫 번째 일치 항목의 인덱스 위치를 반환합니다. re 가 어디에도 일치하지 않으면 -1을 반환합니다.

일치하는 부분이 있고 rmatch 가 nullptr 와 다를 경우, 일치 결과를 rmatch 가 가리키는 QRegularExpressionMatch 객체에 기록합니다.

예시:

QString str = "the minimum";
str.indexOf(QRegularExpression("m[aeiou]"), 0);       // returns 4

QRegularExpressionMatch match;
str.indexOf(QRegularExpression("m[aeiou]"), 0, &match);       // returns 4
// match.captured() == mi

qsizetype QString::indexOf(const QString &str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 “ str ”가 처음 나타나는 위치의 인덱스를 반환하며, 검색은 인덱스 위치 from 부터 앞으로 진행됩니다. “ str ”가 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

예시:

QString x = "sticky question";
QString y = "sti";
x.indexOf(y);               // returns 0
x.indexOf(y, 1);            // returns 10
x.indexOf(y, 10);           // returns 10
x.indexOf(y, 11);           // returns -1

from 가 -1이면 검색은 마지막 문자로부터 시작하고, -2이면 그 다음 마지막 문자로부터 시작하며, 이와 같은 방식으로 진행됩니다.

lastIndexOf(), contains(), count()도 참조하십시오 .

qsizetype QString::indexOf(QChar ch, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 ch 문자가 처음 나타나는 인덱스 위치를 반환하며, 검색은 from 인덱스 위치부터 앞으로 진행됩니다. ch 가 발견되지 않으면 -1을 반환합니다.

[noexcept] qsizetype QString::indexOf(QStringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 “ str ”라는 문자열이 처음 나타나는 인덱스 위치를 반환하며, 검색은 인덱스 위치 “ from ”부터 앞으로 진행됩니다. “ str ”가 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

from 가 -1이면 검색은 마지막 문자로부터 시작하고, -2이면 마지막에서 두 번째 문자로부터 시작하는 식으로 진행됩니다.

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

QString &QString::insert(qsizetype position, const QString &str)

지정된 인덱스 position 에 문자열 str 을 삽입하고, 이 문자열에 대한 참조를 반환합니다.

예시:

QString str = "Meal";
str.insert(1, QString("ontr"));
// str == "Montreal"

이 문자열은 삽입을 수용하기 위해 길이가 늘어납니다. position 이 문자열의 끝을 넘어가는 경우, position 에 도달할 때까지 공백 문자가 문자열 끝에 추가된 후, str 가 이어집니다.

append(), prepend(), replace() 및 remove()도 참조하십시오 .

QString &QString::insert(qsizetype position, QChar ch)

문자열의 지정된 인덱스 position 위치에 ch 을 삽입합니다.

이 삽입을 수용하기 위해 문자열의 길이가 늘어납니다. 만약 position 이 문자열의 끝을 넘어가는 경우, 이 position 에 도달할 수 있도록 공백 문자가 문자열 끝에 추가된 후, ch 이 이어집니다.

QString &QString::insert(qsizetype position, QLatin1StringView str)

str 에서 인식한 Latin-1 문자열을 지정된 인덱스 position 에 삽입합니다.

이 문자열은 삽입을 수용하기 위해 길이가 늘어납니다. position 가 문자열의 끝을 넘어가는 경우, position 에 도달할 때까지 공백 문자가 문자열 끝에 추가된 후, str 가 이어집니다.

[since 6.0] QString &QString::insert(qsizetype position, QStringView str)

지정된 인덱스 position 에 문자열 뷰 str 를 삽입하고, 이 문자열에 대한 참조를 반환합니다.

이 문자열은 삽입을 수용하기 위해 길이가 늘어납니다. position 가 문자열의 끝을 넘어가는 경우, 이 position 에 도달할 때까지 공백 문자가 문자열 끝에 추가된 후, str 가 이어집니다.

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

[since 6.5] QString &QString::insert(qsizetype position, QUtf8StringView str)

지정된 인덱스 position 에 UTF-8 문자열 뷰 str 를 삽입합니다.

이 문자열은 삽입 내용을 수용하기 위해 길이가 늘어납니다. position 가 문자열의 끝을 넘어가는 경우, 이 position 에 도달할 때까지 공백 문자가 문자열 끝에 추가된 후, str 가 이어집니다.

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

QString &QString::insert(qsizetype position, const QByteArray &str)

str 의 내용을 UTF-8로 해석하고, 이를 인코딩한 유니코드 문자열을 지정된 인덱스 position 에 삽입한 후, 이 문자열에 대한 참조를 반환합니다.

이 문자열은 삽입을 수용하기 위해 길이가 늘어납니다. position 가 문자열의 끝을 넘어가는 경우, 이 위치 position 에 도달할 때까지 공백 문자가 문자열 끝에 추가된 후, str 가 뒤따릅니다.

QT_NO_CAST_FROM_ASCII 가 정의된 경우 이 함수는 사용할 수 없습니다.

QString &QString::insert(qsizetype position, const char *str)

지정된 인덱스 position 에 C 문자열 str 을 삽입하고, 이 문자열에 대한 참조를 반환합니다.

이 문자열은 삽입을 수용하기 위해 길이가 늘어납니다. 만약 position 가 문자열의 끝을 넘어가는 경우, 이 position 에 도달할 때까지 공백 문자가 문자열 끝에 추가된 후, str 가 이어집니다.

QT_NO_CAST_FROM_ASCII 가 정의된 경우 이 함수는 사용할 수 없습니다.

QString &QString::insert(qsizetype position, const QChar *unicode, qsizetype size)

QChar 배열 unicode 의 처음 size 자리를, 문자열 내의 지정된 인덱스 position 위치에 삽입합니다.

이 삽입을 수용하기 위해 문자열의 길이가 늘어납니다. position 가 문자열의 끝을 넘어가는 경우, 이 position 에 도달할 때까지 공백 문자가 문자열에 추가된 다음, QChar 배열 unicode 의 size 문자가 이어서 삽입됩니다.

[constexpr noexcept] bool QString::isEmpty() const

문자열에 문자가 없으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

예:

QString().isEmpty();            // returns true
QString("").isEmpty();          // returns true
QString("x").isEmpty();         // returns false
QString("abc").isEmpty();       // returns false

size()도 참조하십시오 .

bool QString::isLower() const

문자열이 소문자인 경우, 즉 toLower() 폴딩 결과와 동일한 경우 true 를 반환합니다.

단, 이것이 문자열에 대문자가 전혀 포함되어 있지 않다는 것을 의미하지는 않습니다 (일부 대문자에는 소문자 변환 형태가 없으므로, toLower()를 적용해도 변경되지 않습니다). 자세한 내용은 유니코드 표준 3.13절을 참조하십시오.

QChar::toLower() 및 isUpper()도 참조하십시오 .

[constexpr] bool QString::isNull() const

이 문자열이 null인 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.

예시:

QString().isNull();             // returns true
QString("").isNull();           // returns false
QString("abc").isNull();        // returns false

Qt는 역사적인 이유로 null 문자열과 빈 문자열을 구분합니다. 대부분의 애플리케이션에서 중요한 것은 문자열에 데이터가 포함되어 있는지 여부이며, 이는 isEmpty() 함수를 사용하여 확인할 수 있습니다.

참조: isEmpty()

bool QString::isRightToLeft() const

문자열이 오른쪽에서 왼쪽으로 읽히는 경우 true 를 반환합니다.

QStringView::isRightToLeft()도 참조하십시오 .

bool QString::isUpper() const

문자열이 대문자로만 구성되어 있는 경우, 즉 toUpper() 폴딩 결과와 동일한 경우 true 을 반환합니다.

단, 이것이 문자열에 소문자가 전혀 포함되어 있지 않다는 것을 의미하지는 않습니다 (일부 소문자는 대문자 변환이 없으므로 toUpper()에 의해 변경되지 않습니다). 자세한 내용은 유니코드 표준 3.13절을 참조하십시오.

QChar::toUpper() 및 isLower()도 참조하십시오 .

[noexcept] bool QString::isValidUtf16() const

문자열에 유효한 UTF-16 인코딩 데이터가 포함되어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false `를 반환합니다.

이 함수는 데이터에 대한 특별한 유효성 검사를 수행하지 않으며, 단지 UTF-16에서 성공적으로 디코딩될 수 있는지 여부만 확인합니다. 데이터는 호스트 바이트 순서로 되어 있는 것으로 간주되며, BOM의 유무는 의미가 없습니다.

QStringView::isValidUtf16()도 참조하십시오 .

이 문자열의 마지막 n 문자를 포함하는 문자열을 반환합니다.

QString x = "Pineapple";
QString y = x.last(5);      // y == "apple"

이 함수들은 Qt 6.0에서 도입되었습니다.

first(), sliced(), endsWith(), chopped(), chop(), truncate() 및 slice()도 참조하십시오 .

qsizetype QString::lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const

문자열 내에서 정규식 re 의 마지막 일치 부분 중, 인덱스 위치 from 보다 앞쪽에서 시작되는 부분의 인덱스 위치를 반환합니다.

from 가 -1이면 검색은 마지막 문자로부터 시작하고, -2이면 마지막에서 두 번째 문자로부터 시작하는 식으로 진행됩니다.

re 이 어디에서도 일치하지 않으면 -1을 반환합니다.

일치하는 부분이 있고 ` rmatch `가 ` nullptr`와 다를 경우, ` rmatch`가 가리키는 ` QRegularExpressionMatch ` 객체에 일치 결과를 기록합니다.

예시:

QString str = "the minimum";
str.lastIndexOf(QRegularExpression("m[aeiou]"));      // returns 8

QRegularExpressionMatch match;
str.lastIndexOf(QRegularExpression("m[aeiou]"), -1, &match);      // returns 8
// match.captured() == mu

qsizetype QString::lastIndexOf(const QString &str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 “ str ”라는 문자열이 마지막으로 나타나는 인덱스 위치를 반환하며, 검색은 인덱스 위치 “ from ”부터 역방향으로 진행됩니다.

from 가 -1이면 검색은 마지막 문자로부터 시작하고, -2이면 두 번째 마지막 문자로부터 시작하며, 이와 같은 방식으로 진행됩니다.

str 가 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

예:

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

indexOf(), contains() 및 count()도 참조하십시오 .

[noexcept, since 6.3] qsizetype QString::lastIndexOf(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

[since 6.2] qsizetype QString::lastIndexOf(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 “ str ”이 마지막으로 나타나는 위치의 인덱스를 반환합니다. “ str ”이 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

예:

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

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

indexOf(), contains() 및 count()도 참조하십시오 .

[noexcept, since 6.2] qsizetype QString::lastIndexOf(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 “ str ” 문자열이 마지막으로 나타나는 인덱스 위치를 반환합니다. “ str ”을 찾을 수 없는 경우 -1을 반환합니다.

cs 가 Qt::CaseSensitive 인 경우(기본값), 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

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

indexOf(), contains() 및 count()도 참조하십시오 .

[since 6.2] qsizetype QString::lastIndexOf(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

문자열 내에서 정규식 re 의 마지막 일치 위치 인덱스를 반환합니다. re 가 어디에도 일치하지 않으면 -1을 반환합니다.

일치 성공 시, rmatch 가 nullptr 와 다를 경우, rmatch 가 가리키는 QRegularExpressionMatch 객체에 일치 결과를 기록합니다.

예시:

QString str = "the minimum";
str.lastIndexOf(QRegularExpression("m[aeiou]"));      // returns 8

QRegularExpressionMatch match;
str.lastIndexOf(QRegularExpression("m[aeiou]"), -1, &match);      // returns 8
// match.captured() == mu

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

[since 6.2] qsizetype QString::lastIndexOf(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 “ str ”이라는 문자열이 마지막으로 나타나는 위치의 인덱스를 반환합니다. “ str ”이 발견되지 않으면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

예시:

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

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

indexOf(), contains() 및 count()도 참조하십시오 .

qsizetype QString::lastIndexOf(QChar ch, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 ‘ ch ’ 문자가 마지막으로 나타나는 위치의 인덱스를, 인덱스 위치 from 에서 역방향으로 검색하여 반환합니다.

qsizetype QString::lastIndexOf(QLatin1StringView str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 ` str ` 함수가 인식한 Latin-1 문자열이 마지막으로 나타나는 인덱스 위치를 반환하며, 이때 인덱스 위치 ` from`부터 역방향으로 검색합니다.

from 가 -1인 경우 검색은 마지막 문자로부터 시작하고, -2인 경우 두 번째 마지막 문자로부터 시작하며, 이와 같은 방식으로 진행됩니다.

str 를 찾지 못하면 -1을 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

예시:

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

indexOf(), contains(), count()도 참조하십시오 .

[noexcept] qsizetype QString::lastIndexOf(QStringView str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열에서 문자열 뷰 ` str `가 마지막으로 나타나는 인덱스 위치를 반환하며, 인덱스 위치 ` from`부터 역방향으로 검색합니다.

from 가 -1이면 검색은 마지막 문자로부터 시작하고, -2이면 두 번째 마지막 문자로부터 시작하는 식으로 진행됩니다.

str 가 발견되지 않으면 -1을 반환합니다.

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

indexOf(), contains(), count()도 참조하십시오 .

이 문자열의 가장 왼쪽 n 개 문자를 포함하는 부분 문자열을 반환합니다(즉, 이 문자열의 시작부터 인덱스 위치 n 에 있는 요소 직전까지의 문자열을 의미합니다. 해당 요소는 포함되지 않습니다).

n 가 범위 밖일 수 없다는 것을 알고 있다면, 속도가 더 빠르기 때문에 새 코드에서는 대신 first()을 사용하십시오.

n 가 size()보다 크거나 같거나, 0보다 작은 경우 문자열 전체가 반환됩니다.

first(), last(), startsWith(), chopped(), chop() 및 truncate()도 참조하십시오 .

QString QString::leftJustified(qsizetype width, QChar fill = u' ', bool truncate = false) const

width 크기의 문자열을 반환하며, 이 문자열은 fill 문자로 채워진 형태입니다.

truncate 가 false 이고, 해당 문자열의 size() 값이 width 보다 크면, 반환되는 문자열은 해당 문자열의 복사본입니다.

QString s = "apple";
QString t = s.leftJustified(8, '.');    // t == "apple..."

truncate 가 true 이고, 문자열의 size()가 width 보다 크면, 위치 width 이후의 문자열 복사본에서 해당 위치 이후의 모든 문자가 제거되고, 그 복사본이 반환됩니다.

QString str = "Pineapple";
str = str.leftJustified(5, '.', true);    // str == "Pinea"

rightJustified()도 참조하십시오 .

[constexpr noexcept] qsizetype QString::length() const

이 문자열의 문자 수를 반환합니다. ` size()`과 동일합니다.

resize()도 참조하십시오 .

[static] int QString::localeAwareCompare(const QString &s1, const QString &s2)

s1 와 s2 를 비교하여, s1 가 s2 보다 작거나 같거나 클 경우 0보다 작거나 같거나 큰 정수를 반환합니다.

비교는 로케일 및 플랫폼에 따라 수행됩니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시할 수 있습니다.

compare(), QLocale, Comparing Strings도 참조하십시오 .

[since 6.0] int QString::localeAwareCompare(QStringView other) const

이 문자열을 ` other ` 문자열과 비교하여, 이 문자열이 ` other ` 문자열보다 작거나, 같거나, 크면 각각 0보다 작거나, 같거나, 큰 정수를 반환합니다.

비교는 로케일 및 플랫폼에 따라 수행됩니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시할 수 있습니다.

localeAwareCompare(*this, other) 와 동일합니다.

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

Comparing Strings도 참조하십시오 .

int QString::localeAwareCompare(const QString &other) const

이 문자열을 other 문자열과 비교하여, 이 문자열이 other 문자열보다 작거나, 같거나, 크면 각각 0보다 작거나, 같거나, 큰 정수를 반환합니다.

비교는 로케일 및 플랫폼에 따라 수행됩니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시할 수 있습니다.

localeAwareCompare(*this, other) 와 동일합니다.

Comparing Strings도 참조하십시오 .

[static, since 6.0] int QString::localeAwareCompare(QStringView s1, QStringView s2)

s1 와 s2 를 비교하여, s1 가 s2 보다 작거나, 같거나, 크면 각각 0보다 작거나, 같거나, 큰 정수를 반환합니다.

비교는 로케일 및 플랫폼에 따라 다르게 수행됩니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시할 수 있습니다.

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

Comparing Strings도 참조하십시오 .

이 함수는 문자열이 이론적으로 담을 수 있는 요소의 최대 개수를 반환합니다. 실제로는 시스템에서 사용할 수 있는 메모리 용량에 따라 이 개수가 훨씬 더 적을 수 있습니다.

이 함수들은 Qt 6.8에서 도입되었습니다.

n 지정된 position 인덱스부터 시작하여, 인덱스 위치 position + n까지(해당 인덱스 위치의 요소는 제외)의 해당 문자열을 포함하는 문자열을 반

position 와 n 가 범위를 벗어날 수 없다는 것을 알고 있다면, 속도가 더 빠르므로 새 코드에서는 대신 sliced()를 사용하십시오.

position 인덱스가 문자열의 길이를 초과하면 빈 문자열을 반환합니다. 지정된 position 위치부터 시작하는 문자열에 n 보다 적은 수의 문자가 있거나, n 가 -1(기본값)인 경우, 이 함수는 지정된 position 위치부터 사용 가능한 모든 문자를 반환합니다.

first(), last(), sliced(), chopped(), chop(), truncate(), slice()함수도 참조하십시오 .

QString QString::normalized(QString::NormalizationForm mode, QChar::UnicodeVersion version = QChar::Unicode_Unassigned) const

유니코드 표준의 지정된 version 에 따라, 지정된 유니코드 정규화 방식 mode 으로 변환된 문자열을 반환합니다.

[since 6.10] QString &QString::nullTerminate()

이 문자열 데이터가 널 종결되지 않은 경우, 이 메서드는 데이터의 심층 복사본을 생성하고 이를 널 종결 처리합니다.

QString 는 기본적으로 null-terminated이지만, 일부 경우(예: fromRawData() 사용 시) 문자열 데이터가 반드시 \0 문자로 끝나는 것은 아니며, 이는 null-terminated 문자열을 기대하는 메서드를 호출할 때 문제가 될 수 있습니다.

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

nullTerminated(), fromRawData() 및 setRawData()도 참조하십시오 .

이 문자열의 복사본을 반환하며, 이 복사본은 항상 null로 종료됩니다.

이 함수들은 Qt 6.10에서 도입되었습니다.

nullTerminate(), fromRawData(), setRawData()도 참조하십시오 .

[static] QString QString::number(long n, int base = 10)

지정된 base 에 따라 숫자 n 에 해당하는 문자열을 반환합니다.

기본 기수는 10이며, 2에서 36 사이의 값이어야 합니다. 10 이외의 기수를 사용할 경우, ` n `는 부호 없는 정수로 처리됩니다.

서식 지정은 항상 QLocale::C, 즉 English/UnitedStates를 사용합니다. 숫자의 지역화된 문자열 표현을 얻으려면 적절한 로케일을 사용하여 QLocale::toString()를 사용하십시오.

long a = 63;
QString s = QString::number(a, 16);             // s == "3f"
QString t = QString::number(a, 16).toUpper();     // t == "3F"

setNum()도 참조하십시오 .

[static] QString QString::number(double n, char format = 'g', int precision = 6)

n 를 나타내는 문자열을 반환합니다.

n 를 나타내는 문자열을 반환하며, 이 문자열은 지정된 format 및 precision 에 따라 서식이 지정됩니다.

지수 형식의 경우, 지수의 부호가 표시되며 최소 두 자리의 자릿수를 가지며, 필요한 경우 지수 앞쪽에 0을 채워 넣습니다.

setNum(), QLocale::toString(), QLocale::FloatingPointPrecisionOption 및 Number formats도 참조하십시오 .

[static] QString QString::number(int n, int base = 10)

[static] QString QString::number(qlonglong n, int base = 10)

[static] QString QString::number(qulonglong n, int base = 10)

[static] QString QString::number(uint n, int base = 10)

[static] QString QString::number(ulong n, int base = 10)

QString &QString::prepend(const QString &str)

이 문자열의 맨 앞에 “ str ” 문자열을 추가하고, 이 문자열에 대한 참조를 반환합니다.

이 작업은 일반적으로 매우 빠릅니다(상수 시간). 이는 ` QString `가 문자열 데이터의 맨 앞에 추가 공간을 미리 할당하므로, 매번 문자열 전체를 재할당하지 않고도 길이를 늘릴 수 있기 때문입니다.

예시:

QString x = "ship";
QString y = "air";
x.prepend(y);
// x == "airship"

append() 및 insert()도 참조하십시오 .

QString &QString::prepend(QChar ch)

이 문자열의 맨 앞에 ch 문자를 추가합니다.

QString &QString::prepend(QLatin1StringView str)

str 가 인식하는 Latin-1 문자열을 이 문자열의 앞에 추가합니다.

[since 6.0] QString &QString::prepend(QStringView str)

이 문자열의 맨 앞에 문자열 뷰 ` str `를 추가하고, 이 문자열에 대한 참조를 반환합니다.

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

[since 6.5] QString &QString::prepend(QUtf8StringView str)

이 문자열의 앞에 UTF-8 문자열 뷰 str 를 추가합니다.

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

QString &QString::prepend(const QByteArray &ba)

이 문자열의 맨 앞에 바이트 배열 ` ba `을 추가합니다. 이 바이트 배열은 ` fromUtf8()` 함수를 사용하여 유니코드로 변환됩니다.

애플리케이션을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `를 정의하여 이 함수를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`를 반드시 거치도록 보장하고자 할 때 유용할 수 있습니다.

QString &QString::prepend(const char *str)

이 문자열의 앞에 “ str ” 문자열을 추가합니다. const char 포인터는 fromUtf8() 함수를 사용하여 유니코드로 변환됩니다.

응용 프로그램을 컴파일할 때 ` QT_NO_CAST_FROM_ASCII `를 정의하여 이 함수를 비활성화할 수 있습니다. 예를 들어, 사용자에게 표시되는 모든 문자열이 ` QObject::tr()`를 반드시 거치도록 보장하고자 할 때 유용할 수 있습니다.

QString &QString::prepend(const QChar *str, qsizetype len)

QChar 배열 str 에 포함된 ‘ len ’ 문자를 이 문자열의 맨 앞에 추가하고, 이 문자열에 대한 참조를 반환합니다.

void QString::push_back(const QString &other)

이 함수는 STL 호환성을 위해 제공되며, 주어진 other 문자열을 이 문자열의 끝에 추가합니다. 이는 append(other) 과 동일합니다.

append()도 참조하십시오 .

void QString::push_back(QChar ch)

지정된 ch 문자를 이 문자열의 끝에 추가합니다.

void QString::push_front(const QString &other)

이 함수는 STL 호환성을 위해 제공되며, 지정된 other 문자열을 이 문자열의 맨 앞에 추가합니다. 이는 prepend(other) 과 동일합니다.

prepend()도 참조하십시오 .

void QString::push_front(QChar ch)

이 문자열의 맨 앞에 지정된 ch 문자를 추가합니다.

QString::reverse_iterator QString::rbegin()

문자열의 첫 번째 문자를 역순으로 가리키는 STL 스타일의 역방향 이터레이터를 반환합니다.

참조: begin(), crbegin(), rend().

QString::const_reverse_iterator QString::rbegin() const

QString &QString::remove(const QRegularExpression &re)

문자열에서 정규식 re 이 나타나는 모든 부분을 제거하고, 해당 문자열에 대한 참조를 반환합니다. 예를 들어:

QString r = "Telephone";
r.remove(QRegularExpression("[aeiou]."));
// r == "The"

요소 제거 시 문자열의 용량은 유지되며 할당된 메모리 양은 줄어들지 않습니다. 여분의 용량을 줄이고 가능한 한 많은 메모리를 해제하려면, 문자열 크기에 대한 마지막 변경이 끝난 후 squeeze()를 호출하십시오.

indexOf(), lastIndexOf() 및 replace()도 참조하십시오 .

QString &QString::remove(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive)

이 문자열에서 ‘ ch ’ 문자가 나타나는 모든 부분을 제거하고, 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

예:

QString t = "Ali Baba";
t.remove(QChar('a'), Qt::CaseInsensitive);
// t == "li Bb"

이는 replace(ch, "", cs) 와 동일합니다.

요소를 제거해도 문자열의 용량은 유지되며 할당된 메모리 양은 줄어들지 않습니다. 여분의 용량을 줄이고 가능한 한 많은 메모리를 해제하려면, 문자열 크기를 마지막으로 변경한 후 ` squeeze()`를 호출하십시오.

replace()도 참조하십시오 .

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

이 문자열에서 지정된 str 문자열이 나타나는 모든 부분을 제거하고, 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

이는 replace(str, "", cs) 와 동일합니다.

요소를 제거해도 문자열의 용량은 유지되며 할당된 메모리 양은 줄어들지 않습니다. 여분의 용량을 줄이고 가능한 한 많은 메모리를 확보하려면, 문자열 크기를 마지막으로 변경한 후 squeeze()를 호출하십시오.

replace()도 참조하십시오 .

QString &QString::remove(qsizetype position, qsizetype n)

지정된 position 인덱스부터 시작하여 문자열에서 n 문자를 제거하고, 해당 문자열에 대한 참조를 반환합니다.

지정된 position 인덱스가 문자열 내에 있지만, position + n 가 문자열의 끝을 넘어가는 경우, 문자열은 지정된 position 위치에서 잘립니다.

n 이 0 이하인 경우 아무 변경도 이루어지지 않습니다.

QString s = "Montreal";
s.remove(1, 4);
// s == "Meal"

요소 제거 시 문자열의 용량은 유지되며 할당된 메모리 양은 줄어들지 않습니다. 여분의 용량을 줄이고 가능한 한 많은 메모리를 해제하려면, 문자열 크기를 마지막으로 변경한 후 squeeze()를 호출하십시오.

insert() 및 replace()도 참조하십시오 .

QString &QString::remove(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive)

str 에 의해 해석된 주어진 Latin-1 문자열이 이 문자열에서 나타나는 모든 부분을 제거하고, 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

이는 replace(str, "", cs) 과 동일합니다.

요소 제거 시 문자열의 용량은 유지되며 할당된 메모리 양은 줄어들지 않습니다. 여분의 용량을 줄이고 가능한 한 많은 메모리를 확보하려면, 문자열 크기를 마지막으로 변경한 후 squeeze()를 호출하십시오.

replace()도 참조하십시오 .

[since 6.5] QString &QString::removeAt(qsizetype pos)

pos 의 인덱스에 있는 문자를 제거합니다. pos 가 범위를 벗어난 경우(즉, pos >= size()인 경우), 이 함수는 아무 작업도 수행하지 않습니다.

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

remove()도 참조하십시오 .

[since 6.5] QString &QString::removeFirst()

이 문자열의 첫 번째 문자를 제거합니다. 문자열이 비어 있는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

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

remove()함수도 참조하십시오 .

[since 6.1] template <typename Predicate> QString &QString::removeIf(Predicate pred)

pred 조건식이 참을 반환하는 모든 요소를 문자열에서 제거합니다. 문자열에 대한 참조를 반환합니다.

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

remove()도 참조하십시오 .

[since 6.5] QString &QString::removeLast()

이 문자열의 마지막 문자를 제거합니다. 문자열이 비어 있으면 이 함수는 아무 작업도 수행하지 않습니다.

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

remove()도 참조하십시오 .

QString::reverse_iterator QString::rend()

문자열의 마지막 문자 바로 다음 위치를 가리키는, 역순으로 작동하는 STL 스타일의 역이테레이터를 반환합니다.

참조: ` end()`, ` crend()`, ` rbegin()`.

QString::const_reverse_iterator QString::rend() const

QString QString::repeated(qsizetype times) const

이 문자열의 복사본을 지정된 횟수만큼 반복하여 반환합니다. times.

times 가 1보다 작으면 빈 문자열이 반환됩니다.

예:

QString str("ab");
str.repeated(4);            // returns "abababab"

QString &QString::replace(qsizetype position, qsizetype n, const QString &after)

인덱스 position 부터 시작하는 n 문자를 문자열 after 로 대체하고, 이 문자열에 대한 참조를 반환합니다.

예:

QString x = "Say yes!";
QString y = "no";
x.replace(4, 3, y);
// x == "Say no!"

insert() 및 remove()도 참조하십시오 .

QString &QString::replace(const QRegularExpression &re, const QString &after)

문자열 내에서 정규 표현식 re 이 나타나는 모든 부분을 after 로 대체합니다. 문자열에 대한 참조를 반환합니다. 예를 들어:

QString s = "Banana";
s.replace(QRegularExpression("a[mn]"), "ox");
// s == "Boxoxa"

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

QString t = "A <i>bon mot</i>.";
t.replace(QRegularExpression("<i>([^<]*)</i>"), "\\emph{\\1}");
// t == "A \\emph{bon mot}."

indexOf(), lastIndexOf(), remove(), QRegularExpression 및 QRegularExpressionMatch도 참조하십시오 .

QString &QString::replace(QChar before, QChar after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

before 문자가 나타나는 모든 곳을 after 문자로 대체하고, 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive 인 경우(기본값), 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

QString &QString::replace(QChar c, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

c 문자가 나타나는 모든 곳을 after 문자열로 대체하고, 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive 인 경우(기본값), 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

QString &QString::replace(QChar ch, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

문자열에서 ch 가 나타나는 모든 부분을 after 로 바꾸고, 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive 인 경우(기본값), 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

QString &QString::replace(QLatin1StringView before, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

이 문자열에서 before 로 해석된 Latin-1 문자열이 나타나는 모든 부분을 after 로 해석된 Latin-1 문자열로 대체하고, 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

QString &QString::replace(QLatin1StringView before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

before 로 해석된 이 문자열 내의 모든 Latin-1 문자열을 after 로 대체하고, 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)인 경우 대소문자를 구분하여 검색하며, 그렇지 않은 경우 대소문자를 구분하지 않고 검색합니다.

QString &QString::replace(const QString &before, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

문자열 “ before ”이 나타나는 모든 부분을 “ after ”으로 바꾸고, 이 문자열에 대한 참조를 반환합니다.