QStringView Class

멤버 함수 문서

sep 이 발생할 때마다 뷰를 하위 문자열 뷰로 분할하고 해당 문자열 뷰의 목록을 반환합니다.

sep, behavior 및 cs 이 상호 작용하여 결과를 형성하는 방법은 QString::split()를 참조하세요.

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

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

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

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

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

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

이 문자열 보기를 라틴-1 문자열 보기 l1 또는 문자 ch 와 비교합니다. 이 문자열 보기가 l1 또는 ch 보다 작으면 음수를, l1 또는 ch 보다 크면 양수를, 같으면 0을 반환합니다.

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

operator==(), operator<() 및 operator>()도 참조하세요 .

이 문자열 보기가 각각 str 에서 보는 UTF-16 문자열, l1 에서 보는 Latin-1 문자열 또는 ch 문자로 시작하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

endsWith()도 참조하세요 .

이 문자열 보기가 각각 str 에서 보는 UTF-16 문자열, l1 에서 보는 Latin-1 문자열 또는 ch 문자로 끝나면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

startsWith()도 참조하세요 .

이 문자열 보기에서 각각 str 에서 보는 UTF-16 문자열, l1 에서 보는 Latin-1 문자열 또는 ch 문자가 처음 나타나는 인덱스 위치를 반환하며, 인덱스 위치 from 에서부터 앞으로 검색합니다. str , l1 또는 ch 를 각각 찾지 못하면 -1을 반환합니다.

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

from 가 -1이면 마지막 문자부터 검색이 시작되고, -2이면 그 다음 마지막 문자부터 검색이 시작됩니다.

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

이 문자열 보기에 str 에서 보는 UTF-16 문자열, l1 에서 보는 Latin-1 문자열 또는 ch 문자가 각각 포함된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

indexOf()도 참조하세요 .

이 문자열 보기에서 각각 str 에서 보는 UTF-16 문자열, l1 에서 보는 Latin-1 문자열 또는 ch 문자의 마지막 발생 인덱스 위치를 반환하며, 인덱스 위치 from 에서부터 역순으로 검색합니다.

from 이 -1이면 마지막 문자부터 검색이 시작되고, -2이면 그 다음 마지막 문자부터 검색이 시작됩니다.

str, l1 또는 c 를 찾을 수 없으면 각각 -1을 반환합니다.

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

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

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

이 문자열 보기의 마지막 문자부터 거꾸로 검색하여 str 또는 l1 에서 각각 보는 UTF-16 문자열 또는 라틴-1 문자열의 마지막 발생 인덱스 위치를 이 문자열 보기에서 반환합니다. str 또는 l1 을 찾을 수 없으면 각각 -1을 반환합니다.

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

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

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

[constexpr noexcept(...), since 6.0] template <typename Needle, typename... Flags> auto QStringView::tokenize(Needle &&sep, Flags... flags) const

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] QStringView::QStringView()

널 문자열 뷰를 구축합니다.

isNull()도 참조하세요 .

[constexpr noexcept] template <typename Char, size_t N> QStringView::QStringView(const Char (&)[N] string)

문자 문자열 리터럴 string 에 문자열 뷰를 구축합니다. 이 뷰는 첫 번째 Char(0) 또는 N 중 먼저 오는 것까지 배열을 포함합니다. 전체 배열이 필요한 경우 fromArray()를 대신 사용합니다.

string 는 이 문자열 보기 객체의 수명 동안 유효해야 합니다.

이 생성자는 Char 가 호환되는 문자 유형인 경우에만 과부하 해결에 참여합니다. 호환되는 문자 유형은 다음과 같습니다: QChar, ushort, char16_t 및 (Windows와 같은 플랫폼에서 16비트 유형인 경우) wchar_t 입니다.

fromArray도 참조하세요 .

[constexpr noexcept] template <typename Char> QStringView::QStringView(const Char *str)

str 에 문자열 뷰를 구축합니다. 길이는 첫 번째 Char(0) 을 검색하여 결정됩니다.

str 는 이 문자열 보기 객체의 수명 동안 유효해야 합니다.

nullptr 을 str 으로 전달하는 것은 안전하며 null 문자열 뷰가 생성됩니다.

이 생성자는 Char 이 호환되는 문자 유형인 경우에만 과부하 해결에 참여합니다. 호환되는 문자 유형은 다음과 같습니다: QChar, ushort, char16_t 및 (Windows와 같은 플랫폼에서 16비트 유형인 경우) wchar_t 입니다.

[constexpr noexcept] template <typename Container, QStringView::if_compatible_container<Container> = true> QStringView::QStringView(const Container &str)

str 에 문자열 뷰를 구축합니다. 길이는 std::size(str) 에서 가져옵니다.

std::data(str) 이 문자열 뷰 객체의 수명 동안 유효해야 합니다.

이 생성자는 Container 이 value_type 과 호환되는 문자 유형을 가진 컨테이너인 경우에만 과부하 해결에 참여합니다. 호환되는 문자 유형은 다음과 같습니다: QChar, ushort, char16_t 및 (Windows와 같은 플랫폼에서 16비트 유형인 경우) wchar_t 입니다.

경우에만 문자열 뷰는 비어 있습니다 std::size(str) == 0. 이 생성자가 널 문자열 뷰를 생성할 수 있는지 여부는 지정되지 않았습니다(std::data(str) 는 nullptr 을 반환해야 합니다).

isNull() 및 isEmpty()도 참조하세요 .

[noexcept] QStringView::QStringView(const QString &str)

str 에 문자열 보기를 구축합니다.

str.data() 는 이 문자열 보기 객체의 수명 동안 유효해야 합니다.

문자열 보기는 str.isNull().

[constexpr noexcept] QStringView::QStringView(std::nullptr_t)

널 문자열 뷰를 구축합니다.

isNull()도 참조하세요 .

[constexpr] template <typename Char, QStringView::if_compatible_char<Char> = true> QStringView::QStringView(const Char *first, const Char *last)

길이 (last - first)를 사용하여 first 에 문자열 보기를 만듭니다.

[first,last) 범위는 이 문자열 보기 객체의 수명 동안 유효해야 합니다.

last 가 nullptr 인 경우 \nullptr 를 first 로 전달해도 안전하며, null 문자열 보기가 생성됩니다.

last 가 first 앞에 오거나 first 가 nullptr 이고 last 가 아닌 경우 동작이 정의되지 않습니다.

이 생성자는 Char 가 호환되는 문자 유형인 경우에만 과부하 해결에 참여합니다. 호환되는 문자 유형은 다음과 같습니다: QChar, ushort, char16_t 및 (Windows와 같은 플랫폼에서 16비트 유형인 경우) wchar_t 입니다.

[constexpr] template <typename Char, QStringView::if_compatible_char<Char> = true> QStringView::QStringView(const Char *str, qsizetype len)

길이가 len 인 str 에 문자열 보기를 작성합니다.

[str,len) 범위는 이 문자열 보기 객체의 수명 동안 유효해야 합니다.

len 가 0인 경우 nullptr 를 str 로 전달해도 안전하며, null 문자열 뷰가 생성됩니다.

len 이 음수이면 동작이 정의되지 않으며, 양수인 경우 str 이 nullptr 이면 동작이 정의되지 않습니다.

이 생성자는 Char 가 호환되는 문자 유형인 경우에만 과부하 해결에 참여합니다. 호환되는 문자 유형은 다음과 같습니다: QChar, ushort, char16_t 및 (Windows와 같은 플랫폼에서 16비트 유형인 경우) wchar_t 입니다.

[constexpr noexcept] QChar QStringView::at(qsizetype n) const

이 문자열 보기에서 n 위치에 있는 문자를 반환합니다.

n 가 음수이거나 size()보다 작으면 동작이 정의되지 않습니다.

operator[](), front() 및 back()도 참조하세요 .

[constexpr] QChar QStringView::back() const

문자열 보기의 마지막 문자를 반환합니다. last ()와 동일합니다.

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

front(), first() 및 last()도 참조하세요 .

[noexcept] QStringView::const_iterator QStringView::begin() const

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

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

end(), constBegin(), cbegin(), rbegin() 및 data()도 참조하세요 .

[noexcept] QStringView::const_iterator QStringView::cbegin() const

begin()와 동일합니다.

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

cend(), begin(), constBegin(), crbegin() 및 data()도 참조하세요 .

[noexcept] QStringView::const_iterator QStringView::cend() const

end()와 동일합니다.

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

cbegin(), end(), constEnd() 및 crend()도 참조하세요 .

[constexpr noexcept] void QStringView::chop(qsizetype length)

이 문자열 보기를 length 문자만큼 잘라냅니다.

*this = left(size() - length) 와 동일합니다.

mid(), left(), right(), chopped(), truncate() 및 slice()도 참조하세요 .

[constexpr noexcept] QStringView QStringView::chopped(qsizetype length) const

이 객체의 시작 부분부터 시작되는 길이 size() - length 의 부분 문자열을 반환합니다.

left(size() - length) 와 동일합니다.

mid(), left(), right(), chop(), truncate() 및 slice()도 참조하세요 .

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

이 문자열 보기를 문자열 보기 str 와 비교하여 이 문자열 보기가 str 보다 작으면 음의 정수를, str 보다 크면 양의 정수를, 같으면 0을 반환합니다.

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

operator==(), operator<() 및 operator>()도 참조하세요 .

[noexcept, since 6.5] int QStringView::compare(QUtf8StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

이 문자열 보기를 QUtf8StringView str 과 비교하여 이 문자열 보기가 str 보다 작으면 음의 정수를, str 보다 크면 양의 정수를, 같으면 0을 반환합니다.

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

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

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

[noexcept, since 6.1] QStringView::const_iterator QStringView::constBegin() const

begin()와 동일합니다.

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

constEnd(), begin(), cbegin(), crbegin() 및 data()도 참조하십시오 .

[noexcept, since 6.0] QStringView::const_pointer QStringView::constData() const

문자열 보기의 첫 번째 문자에 대한 상수 포인터를 반환합니다.

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

data(), begin(), end() 및 utf16()도 참조하세요 .

[noexcept, since 6.1] QStringView::const_iterator QStringView::constEnd() const

end()와 동일합니다.

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

constBegin(), end(), cend() 및 crend()도 참조하십시오 .

[since 6.1] bool QStringView::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

정규식 re 이 이 문자열 보기의 어딘가에 일치하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

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

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

[since 6.1] qsizetype QStringView::count(const QRegularExpression &re) const

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

기록상의 이유로 이 함수는 중복되는 일치 횟수를 계산합니다. 이 동작은 QRegularExpressionMatchIterator 을 사용하여 문자열 보기에서 단순히 일치하는 항목을 반복하는 것과는 다릅니다.

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

QRegularExpression::globalMatch()도 참조하세요 .

[noexcept, since 6.0] qsizetype QStringView::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

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

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

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

[since 6.4] qsizetype QStringView::count(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

이 문자열 보기에서 l1 에서 조회한 라틴-1 문자열의 (중복될 수 있는) 발생 횟수를 반환합니다.

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

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

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

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

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

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

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

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

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

[noexcept] QStringView::const_reverse_iterator QStringView::crbegin() const

rbegin()와 동일합니다.

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

crend(), rbegin() 및 cbegin()도 참조하세요 .

[noexcept] QStringView::const_reverse_iterator QStringView::crend() const

rend()와 동일합니다.

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

crbegin(), rend() 및 cend()도 참조하세요 .

[noexcept] QStringView::const_pointer QStringView::data() const

문자열 보기의 첫 번째 문자에 대한 상수 포인터를 반환합니다.

begin(), end() 및 utf16()도 참조하세요 .

[constexpr noexcept] bool QStringView::empty() const

이 문자열 보기가 비어 있는지 여부, 즉 size() == 0.

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

isEmpty(), isNull(), size() 및 length()도 참조하세요 .

[noexcept] QStringView::const_iterator QStringView::end() const

목록의 마지막 문자 뒤에 있는 가상의 문자를 가리키는 상수 STL 스타일 이터레이터를 반환합니다.

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

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

[constexpr] QChar QStringView::first() const

문자열 보기의 첫 번째 문자를 반환합니다. front ()와 동일합니다.

이 함수는 다른 Qt 컨테이너와의 호환성을 위해 제공됩니다.

front(), back() 및 last()도 참조하세요 .

[constexpr noexcept, since 6.0] QStringView QStringView::first(qsizetype n) const

이 문자열 보기의 첫 번째 n 문자를 가리키는 문자열 보기를 반환합니다.

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

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

[static constexpr noexcept] template <typename Char, size_t Size, QStringView::if_compatible_char<Char> = true> QStringView QStringView::fromArray(const Char (&)[Size] string)

후행 Char(0) 을 포함하여 전체 문자 문자열 리터럴 string 에 문자열 보기를 구성합니다. 뷰에 널 종결자를 포함하지 않으려면 끝 부분에 있는 것이 확실할 때 chop()로 제거할 수 있습니다. 또는 배열 리터럴을 사용하는 생성자 오버로드를 사용하여 데이터의 첫 번째 널 종결자를 포함하지 않고 뷰를 만들 수 있습니다.

string 는 이 문자열 뷰 객체의 수명 동안 유효해야 합니다.

Char 이 호환 가능한 문자 유형인 경우 이 함수는 모든 배열 리터럴에서 작동합니다. 호환되는 문자 유형은 다음과 같습니다: QChar, ushort, char16_t 및 (Windows와 같은 플랫폼에서 16비트 유형인 경우) wchar_t 입니다.

[constexpr] QChar QStringView::front() const

문자열 보기의 첫 번째 문자를 반환합니다. first ()와 동일합니다.

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

back(), first() 및 last()도 참조하세요 .

[since 6.1] qsizetype QStringView::indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const

문자열 보기에서 정규식 re 의 첫 번째 일치하는 인덱스 위치(인덱스 위치 from 부터 앞으로 검색)를 반환합니다. re 이 일치하지 않으면 -1을 반환합니다.

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

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

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

이 문자열 뷰가 비어 있는지 여부, 즉 size() == 0.

이 함수는 다른 Qt 컨테이너와의 호환성을 위해 제공됩니다.

empty(), isNull(), size() 및 length()도 참조하십시오 .

[noexcept, since 6.7] bool QStringView::isLower() const

이 뷰가 소문자 접기와 동일한 경우 true 을 반환합니다.

이는 문자열 보기에 대문자가 포함되어 있지 않음을 의미하지는 않습니다(일부 대문자는 소문자 접기가 없으며 toString().toLower()로 변경되지 않음). 자세한 내용은 유니코드 표준, 섹션 3.13을 참조하십시오.

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

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

[constexpr noexcept] bool QStringView::isNull() const

이 문자열 뷰가 null인지, 즉 data() == nullptr 인지 여부를 반환합니다.

이 함수는 다른 Qt 컨테이너와의 호환성을 위해 제공됩니다.

empty(), isEmpty(), size() 및 length()도 참조하십시오 .

[noexcept] bool QStringView::isRightToLeft() const

문자열 보기를 오른쪽에서 왼쪽으로 읽으면 true 을 반환합니다.

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

[noexcept, since 6.7] bool QStringView::isUpper() const

이 뷰가 대문자 접힘과 동일한 경우 true 을 반환합니다.

이는 문자열 보기에 소문자가 포함되어 있지 않음을 의미하지는 않습니다(일부 소문자는 대문자로 접히지 않으며 toString().toUpper()로 변경되지 않음). 자세한 내용은 유니코드 표준, 섹션 3.13을 참조하십시오.

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

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

[noexcept] bool QStringView::isValidUtf16() const

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

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

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

[constexpr] QChar QStringView::last() const

문자열 보기의 마지막 문자를 반환합니다. back ()와 동일합니다.

이 함수는 다른 Qt 컨테이너와의 호환성을 위해 제공됩니다.

back(), front() 및 first()도 참조하세요 .

[constexpr noexcept, since 6.0] QStringView QStringView::last(qsizetype n) const

이 문자열 보기의 마지막 n 문자를 가리키는 문자열 보기를 반환합니다.

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

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

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

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

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

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

[since 6.1] qsizetype QStringView::lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const

문자열 보기에서 정규식 re 의 마지막 일치 항목의 인덱스 위치(인덱스 위치 from 이전부터 시작)를 반환합니다.

from 이 -1이면 마지막 문자부터 검색이 시작되고, -2이면 그 다음 마지막 문자부터 검색이 시작됩니다.

re 이 일치하는 문자가 없으면 -1을 반환합니다.

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

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

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

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

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

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

size()와 동일합니다.

이 함수는 다른 Qt 컨테이너와의 호환성을 위해 제공됩니다.

empty(), isEmpty(), isNull() 및 size()도 참조하십시오 .

[since 6.4] int QStringView::localeAwareCompare(QStringView other) const

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

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

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

Comparing Strings 를참조하세요 .

[static constexpr noexcept, since 6.8] qsizetype QStringView::maxSize()

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

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

[constexpr noexcept, since 6.8] qsizetype QStringView::max_size() const

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

maxSize()를 반환합니다.

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

[noexcept] QStringView::const_reverse_iterator QStringView::rbegin() const

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

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

rend(), crbegin() 및 begin()도 참조하세요 .

[noexcept] QStringView::const_reverse_iterator QStringView::rend() const

문자열 보기의 마지막 문자를 역순으로 지나가는 문자를 가리키는 STL 스타일의 역방향 반복자를 반환합니다.

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

rbegin(), crend() 및 end()도 참조하세요 .

[constexpr noexcept] qsizetype QStringView::size() const

이 문자열 보기의 크기를 UTF-16 코드 단위로 반환합니다(즉, 이 함수의 목적상 대리 쌍은 QString 에서와 동일하게 두 개로 계산됩니다).

empty(), isEmpty(), isNull() 및 length()도 참조하세요 .

[constexpr, since 6.8] QStringView &QStringView::slice(qsizetype pos, qsizetype n)

pos 위치에서 시작하여 n 코드 포인트까지 확장되도록 이 문자열 보기를 수정합니다.

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

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

[constexpr, since 6.8] QStringView &QStringView::slice(qsizetype pos)

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

이 문자열 보기를 pos 위치에서 시작하여 끝까지 확장하도록 수정합니다.

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

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

[constexpr noexcept, since 6.0] QStringView QStringView::sliced(qsizetype pos, qsizetype n) const

위치 pos 에서 시작하여 이 문자열 보기의 n 문자를 가리키는 문자열 보기를 반환합니다.

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

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

[constexpr noexcept, since 6.0] QStringView QStringView::sliced(qsizetype pos) const

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

이 객체의 pos 위치에서 시작하여 끝까지 확장되는 문자열 보기를 반환합니다.

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

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

[since 6.0] QList<QStringView> QStringView::split(const QRegularExpression &re, Qt::SplitBehavior behavior = Qt::KeepEmptyParts) const

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

정규식 re 이 일치하는 곳마다 문자열을 하위 문자열 보기로 분할하고 해당 문자열의 목록을 반환합니다. re 이 문자열의 어느 곳과도 일치하지 않으면 split()은 이 문자열을 뷰로 포함하는 단일 요소 목록을 반환합니다.

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

[since 6.0] CFStringRef QStringView::toCFString() const

이로부터 CFString을 생성합니다 QStringView.

호출자는 CFString을 소유하고 릴리스할 책임이 있습니다.

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

[since 6.0] double QStringView::toDouble(bool *ok = nullptr) const

double 값으로 변환된 문자열 보기를 반환합니다.

변환이 오버플로되면 무한대를 반환하고, 다른 이유(예: 언더플로)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고, 성공은 *ok 를 true 로 설정하여 보고합니다.

문자열 변환은 항상 'C' 로캘에서 수행됩니다. 로캘 종속 변환의 경우 QLocale::toDouble()를 사용합니다.

역사적인 이유로 이 함수는 수천 개의 그룹 구분 기호를 처리하지 않습니다. 이러한 숫자를 변환해야 하는 경우 QLocale::toDouble()를 사용하십시오.

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

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

[since 6.0] float QStringView::toFloat(bool *ok = nullptr) const

float 값으로 변환된 문자열 보기를 반환합니다.

변환이 오버플로되면 무한대를 반환하고, 다른 이유(예: 언더플로)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고, 성공은 *ok 를 true 로 설정하여 보고합니다.

문자열 변환은 항상 'C' 로캘에서 수행됩니다. 로케일 종속 변환의 경우 QLocale::toFloat()를 사용합니다.

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

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

[since 6.0] int QStringView::toInt(bool *ok = nullptr, int base = 10) const

기본값은 10이며 2에서 36 사이 또는 0이어야 하는 base 을 사용하여 int 으로 변환된 문자열 보기를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

base 이 0이면 C 언어 규칙이 사용됩니다. 문자열 보기가 "0x"로 시작하면 기본 16이 사용되고, 문자열 보기가 "0"으로 시작하면 기본 8이 사용되며, 그렇지 않으면 기본 10이 사용됩니다.

문자열 변환은 항상 'C' 로캘에서 이루어집니다. 로캘 종속 변환의 경우 QLocale::toInt()를 사용합니다.

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

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

QByteArray QStringView::toLatin1() const

문자열의 라틴 1 표현을 QByteArray 로 반환합니다.

문자열에 라틴 1이 아닌 문자가 포함된 경우 동작이 정의되지 않습니다.

toUtf8(), toLocal8Bit() 및 QStringEncoder 를참조하세요 .

QByteArray QStringView::toLocal8Bit() const

문자열의 로컬 8비트 표현을 QByteArray 로 반환합니다.

유닉스 시스템에서는 toUtf8()에 해당하며, Windows에서는 시스템의 현재 코드 페이지가 사용됩니다.

문자열에 로캘의 8비트 인코딩에서 지원하지 않는 문자가 포함된 경우 동작이 정의되지 않습니다.

toLatin1(), toUtf8() 및 QStringEncoder 를참조하세요 .

[since 6.0] long QStringView::toLong(bool *ok = nullptr, int base = 10) const

기본값은 10이며 2에서 36 사이 또는 0이어야 하는 base 을 사용하여 long 으로 변환된 문자열 보기를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

base 이 0이면 C 언어 규칙이 사용됩니다. 문자열 보기가 "0x"로 시작하면 기본 16이 사용되고, 문자열 보기가 "0"으로 시작하면 기본 8이 사용되며, 그렇지 않으면 기본 10이 사용됩니다.

문자열 변환은 항상 'C' 로캘에서 이루어집니다. 로캘 종속 변환의 경우 QLocale::toLong()를 사용합니다.

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

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

[since 6.0] qlonglong QStringView::toLongLong(bool *ok = nullptr, int base = 10) const

기본값은 10이며 2에서 36 사이 또는 0이어야 하는 base 을 사용하여 long long 으로 변환된 문자열 보기를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

base 이 0이면 C 언어 규칙이 사용됩니다. 문자열 보기가 "0x"로 시작하면 기본 16이 사용되고, 문자열 보기가 "0"으로 시작하면 기본 8이 사용되며, 그렇지 않으면 기본 10이 사용됩니다.

문자열 변환은 항상 'C' 로캘에서 이루어집니다. 로캘 종속 변환의 경우 QLocale::toLongLong()를 사용합니다.

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

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

[since 6.0] NSString *QStringView::toNSString() const

이로부터 NSString을 생성합니다 QStringView.

NSString이 자동으로 릴리스됩니다.

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

[since 6.0] short QStringView::toShort(bool *ok = nullptr, int base = 10) const

기본값은 10이며 2에서 36 사이 또는 0이어야 하는 base 을 사용하여 short 으로 변환된 문자열 보기를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

base 이 0이면 C 언어 규칙이 사용됩니다. 문자열 보기가 "0x"로 시작하면 기본 16이 사용되고, 문자열 보기가 "0"으로 시작하면 기본 8이 사용되며, 그렇지 않으면 기본 10이 사용됩니다.

문자열 변환은 항상 'C' 로캘에서 이루어집니다. 로캘 종속 변환의 경우 QLocale::toShort()를 사용합니다.

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

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

QString QStringView::toString() const

이 문자열 뷰 데이터의 딥 카피를 QString 로 반환합니다.

반환 값은 이 문자열 보기가 널인 경우에만 널 QString 이 됩니다.

[since 6.0] uint QStringView::toUInt(bool *ok = nullptr, int base = 10) const

기본값은 10이며 2에서 36 사이 또는 0이어야 하는 base 을 사용하여 unsigned int 으로 변환된 문자열 보기를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

base 이 0이면 C 언어 규칙이 사용됩니다. 문자열 보기가 "0x"로 시작하면 기본 16이 사용되고, 문자열 보기가 "0"으로 시작하면 기본 8이 사용되며, 그렇지 않으면 기본 10이 사용됩니다.

문자열 변환은 항상 'C' 로캘에서 이루어집니다. 로캘 종속 변환의 경우 QLocale::toUInt()를 사용합니다.

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

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

[since 6.0] ulong QStringView::toULong(bool *ok = nullptr, int base = 10) const

기본값은 10이며 2에서 36 사이 또는 0이어야 하는 base 을 사용하여 unsigned long 으로 변환된 문자열 보기를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

base 이 0이면 C 언어 규칙이 사용됩니다. 문자열 보기가 "0x"로 시작하면 기본 16이 사용되고, 문자열 보기가 "0"으로 시작하면 기본 8이 사용되며, 그렇지 않으면 기본 10이 사용됩니다.

문자열 변환은 항상 'C' 로캘에서 이루어집니다. 로캘 종속 변환의 경우 QLocale::toULongLong()를 사용합니다.

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

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

[since 6.0] qulonglong QStringView::toULongLong(bool *ok = nullptr, int base = 10) const

기본값은 10이며 2에서 36 사이 또는 0이어야 하는 base 을 사용하여 unsigned long long 으로 변환된 문자열 보기를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

base 이 0이면 C 언어 규칙이 사용됩니다. 문자열 보기가 "0x"로 시작하면 기본 16이 사용되고, 문자열 보기가 "0"으로 시작하면 기본 8이 사용되며, 그렇지 않으면 기본 10이 사용됩니다.

문자열 변환은 항상 'C' 로캘에서 이루어집니다. 로캘 종속 변환의 경우 QLocale::toULongLong()를 사용합니다.

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

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

[since 6.0] ushort QStringView::toUShort(bool *ok = nullptr, int base = 10) const

기본값은 10이며 2에서 36 사이 또는 0이어야 하는 base 을 사용하여 unsigned short 으로 변환된 문자열 보기를 반환합니다. 변환에 실패하면 0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

base 이 0이면 C 언어 규칙이 사용됩니다. 문자열 보기가 "0x"로 시작하면 기본 16이 사용되고, 문자열 보기가 "0"으로 시작하면 기본 8이 사용되며, 그렇지 않으면 기본 10이 사용됩니다.

문자열 변환은 항상 'C' 로캘에서 이루어집니다. 로캘 종속 변환의 경우 QLocale::toUShort()를 사용합니다.

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

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

QList<uint> QStringView::toUcs4() const

문자열 보기의 UCS-4/UTF-32 표현을 QList<uint>로 반환합니다.

UCS-4는 유니코드 코덱이므로 무손실입니다. 이 문자열 보기의 모든 문자는 UCS-4로 인코딩됩니다. 이 문자열 보기에서 유효하지 않은 코드 단위 시퀀스는 유니코드 대체 문자(QChar::ReplacementCharacter, U+FFFD 에 해당)로 대체됩니다.

반환된 목록은 0으로 끝나지 않습니다.

toUtf8(), toLatin1(), toLocal8Bit() 및 QStringEncoder도 참조하세요 .

QByteArray QStringView::toUtf8() const

문자열 보기의 UTF-8 표현을 QByteArray 로 반환합니다.

UTF-8은 유니코드 코덱이며 QString 와 같은 유니코드 문자열의 모든 문자를 표현할 수 있습니다.

toLatin1(), toLocal8Bit() 및 QStringEncoder 를참조하십시오 .

qsizetype QStringView::toWCharArray(wchar_t *array) const

이 문자열 보기를 주어진 array 으로 변환합니다.

호출자는 array 이 문자열 보기의 wchar_t 인코딩을 담을 수 있을 만큼 충분히 큰지 확인할 책임이 있습니다(문자열 보기와 같은 길이의 배열을 할당하면 항상 충분합니다). 배열은 wchar_t 너비가 2바이트인 플랫폼(예: Windows)에서는 UTF-16으로 인코딩되며, 그렇지 않은 경우(Unix 시스템) wchar_t 너비는 4바이트로 가정하고 데이터는 UCS-4로 기록됩니다.

array 에 기록된 wchar_t 항목의 수를 반환합니다.

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

[noexcept] QStringView QStringView::trimmed() const

선행 및 후행 공백을 제거하고 결과를 반환합니다.

공백은 QChar::isSpace()가 true 을 반환하는 모든 문자를 의미합니다. 여기에는 ASCII 문자 '\t', '\n', '\v', '\f', '\r', ' ' 등이 포함됩니다.

[constexpr noexcept] void QStringView::truncate(qsizetype length)

이 문자열 뷰를 길이에 맞게 잘라냅니다 length.

*this = left(length) 와 동일합니다.

mid(), left(), right(), chopped() 및 chop()도 참조하세요 .

[constexpr noexcept] const QStringView::storage_type *QStringView::utf16() const

문자열 보기의 첫 번째 문자에 대한 상수 포인터를 반환합니다.

storage_type 는 char16_t 입니다.

begin(), end() 및 data()도 참조하세요 .

[noexcept, since 6.7] std::u16string_view QStringView::operator std::u16string_view() const

이 QStringView 객체를 std::u16string_view 객체로 변환합니다. 반환된 뷰는 이 뷰와 동일한 데이터 포인터와 길이를 갖습니다.

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

[constexpr] QChar QStringView::operator[](qsizetype n) const

이 문자열 보기에서 n 위치에 있는 문자를 반환합니다.

n 가 음수이거나 size()보다 작으면 동작이 정의되지 않습니다.

at(), front() 및 back()도 참조하세요 .