QString Class

멤버 기능 문서

문자열의 가장 왼쪽에 n 문자가 포함된 하위 문자열을 반환합니다.

n 가 범위를 벗어날 수 없다는 것을 알고 있다면 새 코드에서 first()를 사용하는 것이 더 빠릅니다.

n 이 size()보다 크거나 같거나 0보다 작으면 전체 문자열이 반환됩니다.

first(), last(), startsWith(), chopped(), chop() 및 truncate()도 참조하세요 .

문자열의 가장 오른쪽에 n 문자가 포함된 부분 문자열을 반환합니다.

n 가 범위를 벗어날 수 없다는 것을 알고 있다면 새 코드에서 last()를 사용하는 것이 더 빠릅니다.

n 이 size()보다 크거나 같거나 0보다 작으면 전체 문자열이 반환됩니다.

endsWith(), last(), first(), sliced(), chopped(), chop(), truncate() 및 slice()도 참조하세요 .

지정된 position 인덱스에서 시작하여 이 문자열의 n 문자가 포함된 문자열을 반환합니다.

position 및 n 이 범위를 벗어날 수 없다는 것을 알고 있다면 새 코드에서 sliced()를 대신 사용하는 것이 더 빠릅니다.

position 인덱스가 문자열 길이를 초과하는 경우 null 문자열을 반환합니다. 지정된 position 에서 시작하는 문자열에 사용 가능한 문자가 n 미만인 경우 또는 n 이 -1(기본값)인 경우 이 함수는 지정된 position 에서 사용 가능한 모든 문자를 반환합니다.

first(), last(), sliced(), chopped(), chop(), truncate() 및 slice()도 참조하세요 .

이 문자열의 첫 n 문자가 포함된 문자열을 반환합니다.

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

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

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

이 문자열의 마지막 n 문자가 포함된 문자열을 반환합니다.

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

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

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

위치 pos 에서 시작하는 n 문자가 포함된 문자열을 반환합니다.

QString x = "Nine pineapples";
QString y = x.sliced(5, 4);            // y == "pine"
QString z = x.sliced(5);               // z == "pineapples"

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

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

이 함수는 오버로드된 함수입니다.

pos 위치에서 시작하여 끝까지 확장되는 이 문자열의 일부가 포함된 문자열을 반환합니다.

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

first(), last(), chopped(), chop(), truncate() 및 slice()도 참조하세요 .

size() - len 이 문자열의 가장 왼쪽 문자가 포함된 문자열을 반환합니다.

endsWith(), first(), last(), sliced(), chop(), truncate() 및 slice()도 참조하세요 .

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

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

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

이 문자열에서 %N 의 발생을 args 의 해당 인수로 대체합니다. 인수는 위치가 아닙니다: args 의 첫 번째는 %N 을 가장 낮은 N (모두), args 의 두 번째는 %N 을 다음으로 낮은 N 등으로 대체합니다.

Args 는 QString, QStringView 또는 QLatin1StringView 로 암시적으로 변환되는 모든 것으로 구성될 수 있습니다.

또한 다음 유형도 지원됩니다: QChar, QLatin1Char.

QString::arg()도 참조하세요 .

sep 이 발생할 때마다 문자열을 하위 문자열 보기로 분할하고 해당 문자열의 지연 시퀀스를 반환합니다.

와 동일합니다.

return QStringTokenizer{std::forward<Needle>(sep), flags...};

와 동일하지만 컴파일러에서 C++17 클래스 템플릿 인수 공제(CTAD)를 활성화하지 않아도 작동합니다.

sep 과 flags 이 어떻게 상호 작용하여 결과를 형성하는지는 QStringTokenizer 을 참조하세요.

QStringTokenizer result = sv.tokenize(sep);

(템플릿 인자 없이)를 작성할 수 있습니다. C++17 CTAD를 사용할 수 없는 경우 반환값을 auto 변수에만 저장해야 합니다:

auto result = sv.tokenize(sep);

이는 QStringTokenizer 의 템플릿 인수가 반환되는 특정 tokenize() 오버로드에 매우 미묘한 종속성을 가지며 일반적으로 구분 기호에 사용되는 유형과 일치하지 않기 때문입니다.

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

QStringTokenizer 및 qTokenize()도 참조하세요 .

[constexpr noexcept] QString::QString()

널 문자열을 생성합니다. 널 문자열도 비어 있는 것으로 간주합니다.

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

QString::QString(QChar ch)

ch 문자를 포함하는 크기 1의 문자열을 생성합니다.

QString::QString(QLatin1StringView str)

str 에서 본 라틴-1 문자열의 복사본을 생성합니다.

fromLatin1()도 참조하세요 .

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 문자 포인터는 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'으로 끝나는 배열을 가리키는 것으로 가정하고 그 길이는 동적으로 결정됩니다. 끝나는 널 문자는 문자열의 일부로 간주되지 않습니다.

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

fromRawData()도 참조하세요 .

QString::QString(qsizetype size, QChar ch)

모든 문자가 ch 으로 설정된 주어진 size 의 문자열을 생성합니다.

fill()도 참조하세요 .

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

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

이 작업은 QString이 암시적으로 공유되기 때문에 일정한 시간이 걸립니다. 따라서 함수에서 QString을 반환하는 속도가 매우 빠릅니다. 공유 인스턴스가 수정되면 복사(쓰기 시 복사)되므로 선형 시간이 걸립니다.

operator=()도 참조하세요 .

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

Move - 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)

이 함수는 append()를 오버로드합니다.

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

QString &QString::append(QLatin1StringView str)

이 함수는 append()를 오버로드합니다.

str 에서 본 라틴어-1 문자열을 이 문자열에 추가합니다.

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

이 함수는 append()를 오버로드합니다.

주어진 문자열 보기 v 를 이 문자열에 추가하고 결과를 반환합니다.

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

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

이 함수는 append()를 오버로드합니다.

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

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

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

이 함수는 append()를 오버로드합니다.

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

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_ASCII 을 정의하여 이 함수를 비활성화할 수 있습니다. 예를 들어 사용자가 볼 수 있는 모든 문자열이 QObject::tr()를 거치도록 하려는 경우 유용할 수 있습니다.

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

이 함수는 append()를 오버로드합니다.

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

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_ASCII 을 정의하여 이 함수를 비활성화할 수 있습니다. 예를 들어 사용자가 볼 수 있는 모든 문자열이 QObject::tr()를 거치도록 하려는 경우 유용할 수 있습니다.

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

이 함수는 append()를 오버로드합니다.

QChar 배열 str 의 len 문자를 이 문자열에 추가합니다.

QString QString::arg(const QString &a, int fieldWidth = 0, QChar fillChar = u' ') const

가장 낮은 번호의 자리 표시자가 문자열 a, 즉 %1, %2, ..., %99 으로 대체된 이 문자열의 복사본을 반환합니다.

fieldWidth 인자 a 가 차지할 최소 공간을 지정합니다. a 이 fieldWidth 보다 적은 공간이 필요한 경우 fieldWidth 에 fillChar 문자가 추가됩니다. 양수 fieldWidth 는 오른쪽 정렬 텍스트를 생성합니다. 음수 fieldWidth 는 왼쪽 정렬 텍스트를 생성합니다.

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

QString i;           // current file's number
QString total;       // number of files to process
QString 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 사이의 범위여야 합니다.

QString QString::arg(QChar a, int fieldWidth = 0, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

QString QString::arg(QLatin1StringView a, int fieldWidth = 0, QChar fillChar = u' ') const

이 함수는 오버로드된 함수입니다.

a, 즉 %1, %2, ..., %99 에서 보는 라틴-1 문자열로 대체된 가장 낮은 번호의 자리 표시자가 있는 이 문자열의 복사본을 반환합니다.

fieldWidth 은 a 이 차지할 최소 공간을 지정합니다. a 이 fieldWidth 보다 적은 공간을 필요로 하는 경우 fieldWidth 에 fillChar 문자가 추가됩니다. 양수 fieldWidth 는 오른쪽 정렬 텍스트를 생성합니다. 음수 fieldWidth 는 왼쪽 정렬 텍스트를 생성합니다.

asprintf()보다 arg()를 사용할 때의 한 가지 장점은 애플리케이션의 문자열이 다른 언어로 번역되는 경우 번호가 매겨진 플레이스 마커의 순서가 바뀔 수 있지만 각 arg()는 위치에 관계없이 대체되지 않은 가장 낮은 번호의 플레이스 마커를 대체한다는 것입니다. 또한 문자열에 %i 자리 표시자가 두 번 이상 나타나면 arg()가 모두 대체합니다.

대체되지 않은 플레이스 마커가 남아 있지 않으면 경고 메시지가 인쇄되고 결과가 정의되지 않습니다. 플레이스 마커 번호는 1에서 99 사이의 범위여야 합니다.

QString QString::arg(QStringView a, int fieldWidth = 0, QChar fillChar = u' ') const

이 함수는 오버로드된 함수입니다.

가장 낮은 번호의 자리 표시자가 문자열 a, 즉 %1, %2, ..., %99 으로 대체된 이 문자열의 복사본을 반환합니다.

fieldWidth 는 a 이 차지할 최소 공간을 지정합니다. a 이 fieldWidth 보다 적은 공간을 필요로 하는 경우 fieldWidth 에 fillChar 문자가 추가됩니다. 양수 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 사이의 범위여야 합니다.

QString QString::arg(char a, int fieldWidth = 0, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

a 인수는 라틴-1 문자로 해석됩니다.

QString QString::arg(int a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

a 인수는 기본적으로 10인 기본값 base 으로 표현되며 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 를참조하세요 .

QString QString::arg(long a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

fieldWidth a 는 fillChar 문자가 채워질 최소 공백을 지정합니다. 양수 값은 오른쪽 정렬 텍스트를 생성하고 음수 값은 왼쪽 정렬 텍스트를 생성합니다.

a 인수는 지정된 base 으로 표현되며, 기본값은 10이고 2에서 36 사이여야 합니다.

'%' 뒤에 '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 를참조하세요 .

QString QString::arg(qlonglong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

fieldWidth a 는 fillChar 문자가 채워질 최소 공백을 지정합니다. 양수 값은 오른쪽 정렬 텍스트를 생성하고 음수 값은 왼쪽 정렬 텍스트를 생성합니다.

base 인수는 정수 a 를 문자열로 변환할 때 사용할 기저를 지정합니다. 자릿수는 2에서 36 사이여야 하며, 8은 8진수, 10진수, 16진수를 나타냅니다.

Number Formats도 참조하세요 .

QString QString::arg(qulonglong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

fieldWidth a 는 fillChar 문자로 채워질 최소 공백을 지정합니다. 양수 값은 오른쪽 정렬 텍스트를 생성하고 음수 값은 왼쪽 정렬 텍스트를 생성합니다.

base 인수는 정수 a 를 문자열로 변환할 때 사용할 기저를 지정합니다. base 는 2에서 36 사이여야 하며, 8은 8진수, 10진수, 16진수입니다.

Number Formats도 참조하세요 .

QString QString::arg(short a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

fieldWidth a 는 fillChar 문자가 채워질 최소 공백을 지정합니다. 양수 값은 오른쪽 정렬 텍스트를 생성하고 음수 값은 왼쪽 정렬 텍스트를 생성합니다.

base 인수는 정수 a 를 문자열로 변환할 때 사용할 기저를 지정합니다. 자릿수는 2에서 36 사이여야 하며, 8은 8진수, 10진수, 16진수를 나타냅니다.

Number Formats도 참조하세요 .

QString QString::arg(uint a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

base 인수는 정수 a 를 문자열로 변환할 때 사용할 기저를 지정합니다. 베이스는 2에서 36 사이여야 합니다.

Number Formats 를참조하세요 .

QString QString::arg(ulong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

fieldWidth a 는 fillChar 문자로 채워질 최소 공백을 지정합니다. 양수 값은 오른쪽 정렬 텍스트를 생성하고 음수 값은 왼쪽 정렬 텍스트를 생성합니다.

base 인수는 정수 a 를 문자열로 변환할 때 사용할 기저를 지정합니다. 기본값은 2에서 36 사이여야 하며, 8은 8진수, 10진수, 16진수를 의미합니다.

Number Formats도 참조하세요 .

QString QString::arg(ushort a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

fieldWidth a 는 fillChar 문자가 채워질 최소 공백을 지정합니다. 양수 값은 오른쪽 정렬 텍스트를 생성하고 음수 값은 왼쪽 정렬 텍스트를 생성합니다.

base 인수는 정수 a 를 문자열로 변환할 때 사용할 기저를 지정합니다. 자릿수는 2에서 36 사이여야 하며, 8은 8진수, 10진수, 16진수를 나타냅니다.

Number Formats도 참조하세요 .

QString QString::arg(double a, int fieldWidth = 0, char format = 'g', int precision = -1, QChar fillChar = u' ') const

이 함수는 arg()를 오버로드합니다.

인자 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, QString::if_compatible_iterator<InputIterator> = true> QString &QString::assign(InputIterator first, InputIterator last)

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

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

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

• 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 과 같으며 음수가 아닌 값이어야 합니다.

이 함수는 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

이 함수는 start()를 오버로드합니다.

qsizetype QString::capacity() const

강제 재할당 없이 문자열에 저장할 수 있는 최대 문자 수를 반환합니다.

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

reserve() 및 squeeze()도 참조하세요 .

QString::const_iterator QString::cbegin() const

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

begin() 및 cend()도 참조하세요 .

QString::const_iterator QString::cend() 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()도 참조하세요 .

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

이 함수는 compare()를 오버로드합니다.

대소문자 구분 설정 cs 을 사용하여 ch 과 비교를 수행합니다.

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

이 함수는 compare()를 오버로드합니다.

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

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

이 함수는 compare()를 오버로드합니다.

대소문자 구분 설정 cs 을 사용하여 s 과 비교를 수행합니다.

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

이 함수는 compare()를 오버로드합니다.

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

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

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

이 함수는 compare()를 오버로드합니다.

대소문자 구분 설정 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)

이 함수는 compare()를 오버로드합니다.

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

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

이 함수는 비교()를 오버로드합니다.

QString::const_iterator QString::constBegin() const

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

begin() 및 constEnd()도 참조하세요 .

const QChar *QString::constData() const

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

포인터는 문자열이 수정되지 않는 동안에만 유효합니다.

data(), operator[]() 및 fromRawData()도 참조하세요 .

QString::const_iterator QString::constEnd() 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

이 함수는 contains()를 오버로드합니다.

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

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

이 함수는 contains()를 오버로드합니다.

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

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

이 함수는 contains()를 오버로드합니다.

이 문자열에 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

이 함수는 count()를 오버로드합니다.

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

기록상의 이유로 이 함수는 중복되는 일치 항목을 계산하므로 아래 예제에서는 "ana" 또는 "ama"의 인스턴스가 네 개 있습니다:

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

이 함수는 count()를 오버로드합니다.

문자열에서 ch 문자의 발생 횟수를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)이면 대소문자를 구분하여 검색하고, 그렇지 않으면 대소문자를 구분하지 않습니다.

contains() 및 indexOf()도 참조하세요 .

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

이 함수는 count()를 오버로드합니다.

이 문자열에서 str 문자열 보기의 (중복될 수 있는) 발생 횟수를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)이면 대소문자를 구분하여 검색하고, 그렇지 않으면 대소문자를 구분하지 않습니다.

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

contains() 및 indexOf()도 참조하세요 .

QString::const_reverse_iterator QString::crbegin() 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();
   ++데이터; }

포인터는 문자열이 다른 방법으로 수정되지 않는 한 유효하게 유지된다는 점에 유의하세요. 읽기 전용 액세스의 경우 constData()가 더 빠른데, 이는 딥 카피가 발생하지 않기 때문입니다.

constData() 및 operator[]()도 참조하세요 .

const QChar *QString::data() const

이 함수는 오버로드된 함수입니다.

fromRawData()도 참조하세요 .

QString::iterator QString::end()

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

begin() 및 constEnd()도 참조하세요 .

QString::const_iterator QString::end() const

이 함수는 end()를 오버로드합니다.

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 을 반환합니다.

이 함수는 endsWith()를 오버로드합니다.

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

이 함수는 endWith()를 오버로드합니다.

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

이 함수는 endsWith()를 오버로드합니다.

문자열이 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()도 참조하세요 .

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

string CFString의 복사본이 포함된 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)

라틴-1 문자열 str 의 첫 size 문자로 초기화된 QString 을 반환합니다.

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

toLatin1(), fromUtf8() 및 fromLocal8Bit()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

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

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

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

이 함수는 오버로드된 함수입니다.

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

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

8비트 문자열 str 의 첫 size 문자로 초기화된 QString 를 반환합니다.

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

유닉스 시스템에서는 fromUtf8()에 해당합니다. Apple 시스템에서 이 함수는 NSString.defaultCStringEncoding 또는 CFStringGetSystemEncoding()을 고려하지 않습니다. 이 함수는 일반적으로 최신 Apple 운영 체제에서 사용해서는 안 되는 레거시 "Western(Mac OS Roman)" 인코딩을 반환하므로 이 함수는 고려하지 않습니다. Windows에서는 시스템의 현재 코드 페이지가 사용됩니다.

toLocal8Bit(), fromLatin1() 및 fromUtf8()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

8비트 문자열 str 으로 초기화된 QString 을 반환합니다.

유닉스 시스템에서는 fromUtf8()에 해당합니다. Apple 시스템에서 이 함수는 NSString.defaultCStringEncoding 또는 CFStringGetSystemEncoding()을 고려하지 않습니다. 이 함수는 일반적으로 최신 Apple 운영 체제에서 사용해서는 안 되는 레거시 "Western(Mac OS Roman)" 인코딩을 반환하므로 이 함수는 고려하지 않습니다. Windows에서는 시스템의 현재 코드 페이지가 사용됩니다.

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

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

이 함수는 오버로드된 함수입니다.

8비트 문자열 str 으로 초기화된 QString 을 반환합니다.

유닉스 시스템에서는 fromUtf8()에 해당합니다. Apple 시스템에서 이 함수는 NSString.defaultCStringEncoding 또는 CFStringGetSystemEncoding()을 고려하지 않습니다. 이 함수는 일반적으로 최신 Apple 운영 체제에서 사용해서는 안 되는 레거시 "Western(Mac OS Roman)" 인코딩을 반환하므로 이 함수는 고려하지 않습니다. Windows에서는 시스템의 현재 코드 페이지가 사용됩니다.

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

string NSString의 복사본이 포함된 QString 을 새로 만듭니다.

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

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

QString 또는 그 사본을 수정하려고 시도하면 데이터의 심층 복사본이 생성되어 원시 데이터가 수정되지 않도록 합니다.

다음은 데이터를 QString 으로 복사할 필요 없이 메모리에 있는 원시 데이터에 QRegularExpression 을 사용하는 방법의 예입니다:

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

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

fromUtf16() 및 setRawData()도 참조하세요 .

[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)

유니코드 문자열 unicode (UTF-32로 인코딩됨)의 첫 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 (ISO-10646-UTF-16으로 인코딩됨)의 첫 size 문자로 초기화된 QString 을 반환합니다.

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

이 함수는 바이트 순서 표시(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 에서 본 라틴-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

QString str = "the minimum";
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

인덱스 위치 from 에서 앞으로 검색하여 이 문자열에서 str 문자열이 처음 나오는 인덱스 위치를 반환합니다. 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

이 함수는 indexOf()를 오버로드합니다.

인덱스 위치 from 에서 앞으로 검색하여 이 문자열에서 ch 문자가 처음 나오는 인덱스 위치를 반환합니다. ch 을 찾을 수 없으면 -1을 반환합니다.

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

이 함수는 indexOf()를 오버로드합니다.

인덱스 위치 from 에서 앞으로 검색하여 이 문자열에서 문자열 보기 str 의 첫 번째 발생의 인덱스 위치를 반환합니다. 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)

이 함수는 insert()를 오버로드합니다.

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

이 문자열은 삽입을 수용하기 위해 늘어납니다. position 이 문자열 끝을 넘어가면 공백 문자가 문자열에 추가되어 position 이 되고 그 뒤에 ch 이 됩니다.

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

이 함수는 insert()를 오버로드합니다.

str 에서 보는 라틴어-1 문자열을 주어진 인덱스 position 에 삽입합니다.

이 문자열은 삽입을 수용하기 위해 늘어납니다. position 이 문자열의 끝을 넘어가면 공백 문자가 문자열에 추가되어 position 에 도달한 다음 str 이 됩니다.

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

이 함수는 insert()를 오버로드합니다.

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

이 문자열은 삽입을 수용하기 위해 늘어납니다. position 이 문자열의 끝을 넘어가면 공백 문자가 문자열에 추가되어 position 에 도달한 다음 str 이 됩니다.

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

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

이 함수는 insert()를 오버로드합니다.

주어진 인덱스 position 에 UTF-8 문자열 뷰 str 를 삽입합니다.

이 문자열은 삽입에 따라 길이가 늘어납니다. position 이 문자열의 끝을 넘어가면 공백 문자가 추가되어 position 이 되고 그 뒤에 str 이 됩니다.

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

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

이 함수는 insert()를 오버로드합니다.

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

이 문자열은 삽입을 수용하기 위해 커집니다. position 이 문자열의 끝을 넘어가면 공백 문자가 문자열에 추가되어 position 이 되고 그 뒤에 str 이 됩니다.

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

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

이 함수는 insert()를 오버로드합니다.

주어진 인덱스 position 에 C 문자열 str 을 삽입하고 이 문자열에 대한 참조를 반환합니다.

이 문자열은 삽입을 수용하기 위해 커집니다. position 이 문자열의 끝을 넘어가면 공백 문자가 문자열에 추가되어 position 에 도달한 다음 str 이 됩니다.

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

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

이 함수는 insert()를 오버로드합니다.

QChar 배열 unicode 의 첫 번째 size 문자를 문자열의 지정된 인덱스 position 에 삽입합니다.

이 문자열은 삽입을 수용하기 위해 늘어납니다. position 이 문자열 끝을 넘어가면 공백 문자가 문자열에 추가되어 position 에 도달한 다음 QChar 배열의 size 문자가 unicode 에 도달합니다.

[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()도 참조하세요 .

bool QString::isNull() const

이 문자열이 null이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

예제:

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

Qt는 역사적인 이유로 널 문자열과 빈 문자열을 구분합니다. 대부분의 애플리케이션에서 중요한 것은 문자열에 데이터가 포함되어 있는지 여부이며, 이는 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()도 참조하세요 .

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

QString str = "the minimum";
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

인덱스 위치 from 에서 역방향으로 검색하여 이 문자열에서 str 이 마지막으로 발생한 문자열의 인덱스 위치를 반환합니다.

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

이 함수는 lastIndexOf()를 오버로드합니다.

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

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

이 함수는 lastIndexOf()를 오버로드합니다.

이 문자열에서 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

이 함수는 lastIndexOf()를 오버로드합니다.

이 문자열에서 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

이 함수는 lastIndexOf()를 오버로드합니다.

문자열에서 re 정규식과 마지막으로 일치하는 인덱스 위치를 반환합니다. re 이 일치하지 않으면 -1을 반환합니다.

일치에 성공하고 rmatch 가 nullptr 이 아닌 경우 rmatch 이 가리키는 QRegularExpressionMatch 객체에 일치 결과도 씁니다.

예시:

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

QString str = "the minimum";
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

이 함수는 lastIndexOf()를 오버로드합니다.

이 문자열에서 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

이 함수는 lastIndexOf()를 오버로드합니다.

인덱스 위치 from 에서 역방향으로 검색하여 이 문자열에서 ch 문자가 마지막으로 발생한 인덱스 위치를 반환합니다.

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

이 함수는 lastIndexOf()를 오버로드합니다.

이 문자열에서 str 에서 마지막으로 본 라틴-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

이 함수는 lastIndexOf()를 오버로드합니다.

인덱스 위치 from 에서 역방향으로 검색하여 이 문자열에서 str 보기의 마지막 발생의 인덱스 위치를 반환합니다.

from 이 -1이면 마지막 문자에서 검색을 시작하고, -2이면 마지막 문자 다음에서 검색하는 식으로 검색합니다.

str 을 찾을 수 없으면 -1을 반환합니다.

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

indexOf(), contains() 및 count()도 참조하세요 .

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

fill 문자로 패딩된 이 문자열이 포함된 width 크기의 문자열을 반환합니다.

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()도 참조하세요 .

[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

이 함수는 localeAwareCompare()를 오버로드합니다.

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

비교는 로캘 및 플랫폼에 따라 달라집니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시합니다.

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

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

Comparing Strings도 참조하십시오 .

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

이 함수는 localeAwareCompare()를 오버로드합니다.

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

비교는 로캘 및 플랫폼에 따라 달라집니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시합니다.

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

Comparing Strings도 참조하세요 .

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

이 함수는 localeAwareCompare()를 오버로드합니다.

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

비교는 로캘 및 플랫폼에 따라 달라집니다. 이 함수를 사용하여 사용자에게 정렬된 문자열 목록을 표시합니다.

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

Comparing Strings 를참조하세요 .

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

유니코드 표준의 주어진 version 에 따라 주어진 유니코드 정규화 mode 로 문자열을 반환합니다.

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

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

기본값은 10이며 2에서 36 사이여야 합니다. 10 이외의 기저의 경우 n 는 부호 없는 정수로 처리됩니다.

서식은 항상 QLocale::C, 즉 영어/미국식을 사용합니다. 숫자의 지역화된 문자열 표현을 얻으려면 적절한 로캘과 함께 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.

지정된 format 및 precision 에 따라 포맷된 n 을 나타내는 문자열을 반환합니다.

지수가 포함된 형식의 경우, 지수는 부호를 표시하고 최소 두 자리 숫자를 가지며 필요한 경우 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)

이 함수는 prepend()를 오버로드합니다.

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

QString &QString::prepend(QLatin1StringView str)

이 함수는 prepend()를 오버로드합니다.

str 에서 본 라틴어-1 문자열을 이 문자열에 추가합니다.

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

이 함수는 prepend()를 오버로드합니다.

문자열 보기 str 를 이 문자열의 시작 부분에 추가하고 이 문자열에 대한 참조를 반환합니다.

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

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

이 함수는 prepend()를 오버로드합니다.

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

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

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

이 함수는 prepend()를 오버로드합니다.

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

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_ASCII 을 정의하여 이 함수를 비활성화할 수 있습니다. 예를 들어 사용자가 볼 수 있는 모든 문자열이 QObject::tr()를 거치도록 하려는 경우 유용할 수 있습니다.

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

이 함수는 prepend()를 오버로드합니다.

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

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_ASCII 을 정의하여 이 함수를 비활성화할 수 있습니다. 예를 들어 사용자가 볼 수 있는 모든 문자열이 QObject::tr()를 거치도록 하려는 경우 유용할 수 있습니다.

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

이 함수는 prepend()를 오버로드합니다.

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 에서 조회한 지정된 라틴-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)

이 함수는 replace()를 오버로드합니다.

문자열에서 정규식 re 의 모든 항목을 after 으로 바꿉니다. 문자열에 대한 참조를 반환합니다. 예를 들어

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

캡처 그룹이 포함된 정규식의 경우 after 에서 \1, \2, ..., 이 있는 경우 해당 캡처 그룹에 의해 캡처된 문자열로 바뀝니다.

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)

이 함수는 replace()를 오버로드합니다.

before 문자의 모든 항목을 after 문자로 바꾸고 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)이면 대소문자를 구분하여 검색하고, 그렇지 않으면 대소문자를 구분하지 않습니다.

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

이 함수는 replace()를 오버로드합니다.

c 문자의 모든 항목을 after 문자열로 바꾸고 이 문자열에 대한 참조를 반환합니다.

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

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

이 함수는 replace()를 오버로드합니다.

문자열에 있는 모든 ch 문자를 after 으로 바꾸고 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)이면 대소문자를 구분하여 검색하고, 그렇지 않으면 대소문자를 구분하지 않고 검색합니다.

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

이 함수는 replace()를 오버로드합니다.

before 에서 보는 라틴-1 문자열의 이 문자열에 있는 모든 항목을 after 에서 보는 라틴-1 문자열로 바꾸고 이 문자열에 대한 참조를 반환합니다.

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

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

이 함수는 replace()를 오버로드합니다.

before 에서 조회한 라틴-1 문자열의 이 문자열에 있는 모든 항목을 after 문자열로 바꾸고 이 문자열에 대한 참조를 반환합니다.

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

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

이 함수는 replace()를 오버로드합니다.

before 문자열의 모든 항목을 after 문자열로 바꾸고 이 문자열에 대한 참조를 반환합니다.

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

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

이 함수는 replace()를 오버로드합니다.

before 문자열의 모든 항목을 after 문자열로 바꾸고 이 문자열에 대한 참조를 반환합니다.

cs 가 Qt::CaseSensitive (기본값)이면 대소문자를 구분하여 검색하고, 그렇지 않으면 대소문자를 구분하지 않습니다.

예:

QString str = "colour behaviour flavour neighbour";
str.replace(QString("ou"), QString("o"));
// str == "color behavior flavor neighbor"

예: 예:

QString equis = "xxxxxx";
equis.replace("xx", "x");
// equis == "xxx"

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

이 함수는 replace()를 오버로드합니다.

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

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