QUtf8StringView Class

    void myfun1(QUtf8StringView sv);        // preferred
    void myfun2(const QUtf8StringView &sv); // compiles and works, but slower

멤버 함수 문서

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

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

isNull()도 참조하십시오 .

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

문자열 리터럴 ` string`을 기반으로 문자열 뷰를 생성합니다. 이 뷰는 첫 번째 ` Char(0) `이 나타나거나 ` N`이 발생할 때까지 배열을 포함하며, 둘 중 먼저 발생하는 시점을 기준으로 합니다. 전체 배열이 필요한 경우 대신 ` fromArray()`을 사용하십시오.

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

제약 조건

string 가 실제 배열이고, Char 가 호환 가능한 문자 유형인 경우에만 오버로드 해결에 참여합니다. 호환 가능한 문자 유형은 다음과 같습니다: char8_t, char, signed char 및 unsigned char.

fromArray()도 참조하십시오 .

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

str 에 문자열 뷰를 생성합니다. 길이는 첫 번째 Char(0) 를 찾아 스캔하여 결정됩니다.

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

` nullptr `을 ` str `로 전달하는 것은 안전하며, 이 경우 빈 문자열 뷰가 생성됩니다.

제약 조건

str 가 배열이 아니고 Char 가 호환 가능한 문자 유형인 경우에만 오버로드 해결에 참여합니다. 호환 가능한 문자 유형은 char8_t, char, signed char 및 unsigned char 입니다.

[constexpr noexcept] template <typename Container> requires if_compatible_container<Container> QUtf8StringView::QUtf8StringView(const Container &str)

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

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

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

제약 조건

Container 가 value_type 와 호환되는 문자 유형을 가진 컨테이너인 경우에만 오버로드 해결에 참여합니다. 호환되는 문자 유형은 char8_t, char, signed char 및 unsigned char 입니다.

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

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

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

isNull()도 참조하십시오 .

[constexpr] template <typename Char> requires if_compatible_char<Char> QUtf8StringView::QUtf8StringView(const Char *first, const Char *last)

first 에 길이 (last - first)인 문자열 뷰를 생성합니다.

[first,last) 범위는 이 문자열 뷰 객체의 수명 기간 동안 유효한 상태를 유지해야 합니다.

last 또한 nullptr 인 경우, \nullptr 을 first 으로 전달하는 것은 안전하며, 그 결과 null 문자열 뷰가 생성됩니다.

last 가 first 보다 앞에 오거나, first 가 nullptr 인 반면 last 가 가 아닌 경우, 동작은 정의되지 않습니다.

제약 조건

Char 가 호환 가능한 문자 유형인 경우에만 오버로드 해결에 참여합니다. 호환 가능한 문자 유형은 다음과 같습니다: char8_t, char, signed char 및 unsigned char.

[constexpr] template <typename Char> requires if_compatible_char<Char> QUtf8StringView::QUtf8StringView(const Char *str, qsizetype len)

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

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

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

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

제약 조건

Char 가 호환 가능한 문자 유형인 경우에만 오버로드 해결에 참여합니다. 호환 가능한 문자 유형은 다음과 같습니다: char8_t, char, signed char 및 unsigned char.

[since 6.9] template <typename... Args> QString QUtf8StringView::arg(Args &&... args) const

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

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

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

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

[constexpr] QUtf8StringView::storage_type QUtf8StringView::at(qsizetype n) const

이 문자열 뷰에서 n 위치에 있는 코드 포인트를 반환합니다.

n 가 음수이거나 size()보다 크거나 같을 경우 동작이 정의되지 않습니다.

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

[constexpr] QUtf8StringView::storage_type QUtf8StringView::back() const

문자열 뷰의 마지막 코드 포인트를 반환합니다. ` last()`와 동일합니다.

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

front()도 참조하십시오 .

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

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

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

end(), cbegin(), rbegin() 및 data()도 참조하십시오 .

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

begin()와 동일합니다.

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

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

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

end()와 동일합니다.

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

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

[constexpr] void QUtf8StringView::chop(qsizetype n)

이 문자열 뷰를 n 개의 코드 포인트만큼 잘라냅니다.

*this = first(size() - n) 와 동일합니다.

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

[constexpr] QUtf8StringView QUtf8StringView::chopped(qsizetype n) const

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

first(size() - n) 와 동일합니다.

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

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

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

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

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

rbegin()와 동일합니다.

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

crend(), rbegin() 및 cbegin()도 참조하십시오 .

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

rend()와 동일합니다.

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

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

[constexpr noexcept] QUtf8StringView::const_pointer QUtf8StringView::data() const

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

begin(), end() 및 utf8()도 참조하십시오 .

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

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

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

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

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

목록의 마지막 코드 포인트 바로 다음의 가상의 코드 포인트를 가리키는 const STL 스타일 이터레이터를 반환합니다.

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

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

[constexpr] QUtf8StringView QUtf8StringView::first(qsizetype n) const

이 문자열 뷰의 처음 n 코드 포인트를 포함하는 문자열 뷰를 반환합니다.

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

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

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

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

Char 가 호환 가능한 문자 유형인 경우, 이 함수는 모든 배열 리터럴에서 작동합니다. 호환 가능한 문자 유형은 다음과 같습니다: char8_t, char, signed char 및 unsigned char.

[constexpr] QUtf8StringView::storage_type QUtf8StringView::front() const

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

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

back()도 참조하십시오 .

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

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

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

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

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

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

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

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

[noexcept, since 6.3] bool QUtf8StringView::isValidUtf8() const

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

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

[constexpr] QUtf8StringView QUtf8StringView::last(qsizetype n) const

이 문자열 뷰의 마지막 n 코드 포인트를 포함하는 문자열 뷰를 반환합니다.

참조: first(), sliced(), chopped(), chop(), truncate(), slice().

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

size()과 동일합니다.

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

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

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

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

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

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

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

maxSize()를 반환합니다.

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

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

문자열 뷰의 첫 번째 코드 포인트를 가리키는, 역순으로 정렬된 STL 스타일의 const 역방향 이터레이터를 반환합니다.

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

rend(), crbegin() 및 begin()도 참조하십시오 .

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

문자열 뷰의 마지막 코드 포인트 바로 다음 위치(역순)를 가리키는 STL 스타일의 역방향 이터레이터를 반환합니다.

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

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

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

이 문자열 뷰의 크기를 UTF-8 코드 포인트 단위로 반환합니다(즉, 이 함수에서는 멀티바이트 시퀀스가 1개 이상으로 계산되며, 이는 QString 및 QStringView 에 설명된 대리 쌍(surrogate pairs)의 처리 방식과 동일합니다).

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

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

이 문자열 뷰를 수정하여 pos 위치에서 시작하도록 하고, n 코드 포인트만큼 확장합니다.

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

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

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

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

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

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

[constexpr] QUtf8StringView QUtf8StringView::sliced(qsizetype pos) const

이 객체의 pos 위치부터 시작하여 끝까지 이어지는 문자열 뷰를 반환합니다.

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

[constexpr] QUtf8StringView QUtf8StringView::sliced(qsizetype pos, qsizetype n) const

이 문자열 뷰의 n 코드 포인트를 포함하는 문자열 뷰를, 위치 pos 부터 시작하여 반환합니다.

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

QString QUtf8StringView::toString() const

이 문자열 뷰의 데이터에 대한 딥 카피를 ` QString` 형식으로 반환합니다.

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

[constexpr] void QUtf8StringView::truncate(qsizetype n)

이 문자열 뷰를 n 코드 포인트로 잘라냅니다.

*this = first(n) 와 동일합니다.

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

[noexcept] const char8_t *QUtf8StringView::utf8() const

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

결과는 ` const char8_t*` 형식으로 반환되므로, 이 함수는 C++20 모드로 컴파일할 때만 사용할 수 있습니다.

begin(), end() 및 data()도 참조하십시오 .

[noexcept, since 6.7] QUtf8StringView::operator std::string_view() const

이 QUtf8StringView 객체를 std::string_view 객체로 변환합니다. 반환된 뷰는 이 뷰와 동일한 데이터 포인터와 길이를 갖게 됩니다.

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

[noexcept, since 6.10] QUtf8StringView::operator std::u8string_view() const

이 QUtf8StringView 객체를 std::u8string_view 객체로 변환합니다. 반환된 뷰는 이 뷰와 동일한 데이터 포인터와 길이를 갖게 됩니다.

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

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

[constexpr] QUtf8StringView::storage_type QUtf8StringView::operator[](qsizetype n) const

이 문자열 뷰에서 n 위치에 있는 코드 포인트를 반환합니다.

n 가 음수이거나 size()보다 크거나 같을 경우, 동작은 정의되지 않습니다.

at(), front() 및 back()도 참조하십시오 .