QStringView Class

멤버 함수 설명서

[constexpr noexcept] QStringView::QStringView()

빈 문자열 뷰를 생성합니다.

isNull()도 참조하십시오 .

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

문자열 리터럴 ` 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 `로 전달하는 것은 안전하며, 이 경우 빈 문자열 뷰가 생성됩니다.

제약 조건

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) 이 문자열 뷰 객체의 수명 기간 동안 유효한 상태를 유지해야 합니다.

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

제약 조건

Container 가 value_type 와 호환되는 문자 유형을 가진 컨테이너인 경우에만 오버로드 해결에 참여합니다. 호환되는 문자 유형은 QChar, ushort, char16_t 및 (Windows와 같이 16비트 유형인 플랫폼의 경우) wchar_t 입니다.

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

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

str 에 문자열 뷰를 생성합니다.

str.data() 이 문자열 뷰 객체의 수명 기간 동안 유효한 상태를 유지해야 합니다.

str.isNull() 인 경우에만 문자열 뷰가 null이 됩니다.

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

first 에 길이 (last - 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)

str 에 길이 len 인 문자열 뷰를 생성합니다.

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

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

len 가 음수이거나, 양수인 경우 str 가 nullptr 인 경우 동작은 정의되지 않습니다.

제약 조건

Char 가 호환 가능한 문자형일 경우에만 오버로드 해결에 참여합니다. 호환 가능한 문자형은 다음과 같습니다: QChar, ushort, char16_t 및 (Windows와 같이 16비트 유형인 플랫폼의 경우) wchar_t.

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

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

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

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

[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

문자열 뷰의 첫 번째 문자를 가리키는 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) 와 동일합니다.

sliced(), left(), right(), chopped(), truncate(), slice()도 참조하십시오 .

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

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

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

sliced(), left(), right(), chop(), truncate() 및 slice()도 참조하십시오 .

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

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

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

[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

문자열 뷰의 첫 번째 문자에 대한 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()도 참조하십시오 .

이 문자열 뷰에 str 에서 표시되는 UTF-16 문자열, l1 에서 표시되는 Latin-1 문자열, 또는 ch 에서 표시되는 문자가 포함되어 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

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

indexOf()도 참조하십시오 .

[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

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

이 문자열 뷰에서 l1 에 의해 인식된 Latin-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

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

문자열 뷰의 첫 번째 문자에 대한 const 포인터를 반환합니다.

참조: begin(), end(), utf16().

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

이 문자열 뷰가 비어 있는지, 즉 ` size() == 0`인지 여부를 반환합니다.

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

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

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

목록의 마지막 문자 다음에 오는 가상의 문자를 가리키는 const STL 스타일의 반복자를 반환합니다.

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

begin(), constEnd(), cend(), rend()도 참조하십시오 .

이 문자열 뷰가 str 에서 표시되는 UTF-16 문자열, l1 에서 표시되는 Latin-1 문자열, 또는 ch 에서 표시되는 문자로 끝나는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

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

startsWith()도 참조하십시오 .

[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 (&string)[Size])

Size 개의 요소로 구성된 전체 문자열 리터럴 string 에 대해, 끝에 있는 Char(0) 를 포함하여 문자열 뷰를 생성합니다. 뷰에 null 종결자를 포함하지 않으려면, 해당 종결자가 끝 부분임을 확실히 알 때 chop()를 호출하여 제외할 수 있습니다. 또는 배열 리터럴을 인수로 받는 생성자 오버로드를 사용할 수 있는데, 이 경우 데이터 내의 첫 번째 null-terminator 바로 앞까지(해당 문자는 제외) 뷰를 생성합니다.

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

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

[constexpr] QChar QStringView::front() const

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

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

back(), first, last도 참조하십시오 .

이 문자열 뷰에서 인덱스 위치 from 부터 앞으로 검색하여, str 로 표시된 UTF-16 문자열, l1 로 표시된 Latin-1 문자열, 또는 ch 로 표시된 문자가 각각 처음 나타나는 인덱스 위치를 반환합니다. str, l1 또는 ch 가 각각 발견되지 않으면 -1을 반환합니다.

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

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

QString::indexOf()함수도 참조하십시오 .

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

인덱스 위치 from 부터 앞으로 검색하여, 문자열 뷰에서 정규식 re 의 첫 번째 일치 항목의 인덱스 위치를 반환합니다. 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에서 도입되었습니다.

이 문자열 뷰에서 from 인덱스 위치부터 역방향으로 검색하여, str 로 확인된 UTF-16 문자열, l1 로 확인된 Latin-1 문자열, 또는 ch 로 확인된 문자가 각각 마지막으로 나타나는 인덱스 위치를 반환합니다.

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

str, l1 또는 ch 이 각각 발견되지 않으면 -1을 반환합니다.

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

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

[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 ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

이 문자열 뷰의 마지막 문자부터 역방향으로 검색하여, str 로 표시되는 UTF-16 문자열 또는 l1 로 표시되는 Latin-1 문자열이 마지막으로 나타나는 인덱스 위치를 반환합니다. str 또는 l1 가 각각 발견되지 않으면 -1을 반환합니다.

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

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

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

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

size()와 동일합니다.

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

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

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

이 문자열 뷰와 ` other ` 문자열 뷰를 비교하여, 이 문자열 뷰가 ` other ` 문자열 뷰보다 작거나, 같거나, 크면 각각 0보다 작은 정수, 0, 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

문자열 뷰의 첫 번째 문자를 역순으로 가리키는 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 코드 유닛 단위로 반환합니다(즉, 이 함수에서는 대리 쌍이 2개로 계산되며, 이는 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()도 참조하십시오 .

sep 가 나타나는 모든 위치에서 뷰를 부분 문자열 뷰로 분할하고, 해당 문자열 뷰들의 목록을 반환합니다.

sep, behavior 및 cs 가 어떻게 상호 작용하여 결과를 형성하는지에 대해서는 QString::split()을 참조하십시오.

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

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

정규 표현식 re 과 일치하는 모든 위치에서 문자열을 부분 문자열 뷰로 분할하고, 해당 문자열들의 목록을 반환합니다. re 이 문자열 내 어디에서도 일치하지 않는 경우, split()은 이 문자열을 뷰로 포함하는 단일 요소 목록을 반환합니다.

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

이 문자열 뷰가 str 에서 표시되는 UTF-16 문자열, l1 에서 표시되는 Latin-1 문자열, 또는 ch 에서 표시되는 문자로 시작하는 경우 각각 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

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

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

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

이 QStringView 객체를 사용하여 CFString을 생성합니다.

호출자는 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 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

문자열을 Latin-1 형식으로 변환한 값을 ` QByteArray` 객체로 반환합니다.

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

toUtf8(), toLocal8Bit(), QStringEncoder도 참조하십시오 .

QByteArray QStringView::toLocal8Bit() const

문자열을 QByteArray 형식으로 변환한 로컬 8비트 표현을 반환합니다.

유닉스 시스템에서는 이 함수가 ` toUtf8()`와 동일하게 동작하며, 윈도우에서는 시스템의 현재 코드 페이지가 사용됩니다.

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

toLatin1(), toUtf8() 및 QStringEncoder도 참조하십시오 .

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

기본값이 10이며 2에서 36 사이의 값 또는 0이어야 하는 base 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 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

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

NSString은 자동 해제됩니다.

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

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

기본값이 10이며 2에서 36 사이의 값이어야 하는 base 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` 형식으로 반환합니다.

이 문자열 뷰가 null인 경우에만 반환값은 null인 ` QString `이 됩니다.

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

기본값이 10이며 2에서 36 사이의 값 또는 0이어야 하는 base 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 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 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 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()함수도 참조하십시오 .

[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()도 참조하십시오 .

[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) 과 동일합니다.

sliced(), left(), right(), chopped() 및 chop()도 참조하십시오 .

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

문자열 뷰의 첫 번째 문자에 대한 const 포인터를 반환합니다.

storage_type char16_t 입니다.

참조: ` begin()`, ` end()`, ` data()`.

[constexpr noexcept, since 6.7] 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()도 참조하십시오 .