QUtf8StringView Class

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

멤버 함수 문서

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

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

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

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

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

isNull()도 참조하세요 .

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

문자 문자열 리터럴 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 으로 전달하는 것은 안전하며 null 문자열 뷰가 생성됩니다.

이 생성자는 str 가 배열이 아니고 Char 가 호환되는 문자 유형인 경우에만 과부하 해결에 참여합니다. 호환되는 문자 유형은 다음과 같습니다: char8_t, char, signed char 및 unsigned char 입니다.

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

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

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

이 생성자는 Container 이 value_type 과 호환되는 문자 유형을 가진 컨테이너인 경우에만 과부하 해결에 참여합니다. 호환되는 문자 유형은 char8_t, char, signed char 및 unsigned char 입니다.

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

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

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

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

isNull()도 참조하세요 .

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

길이 (last - first)를 사용하여 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, QUtf8StringView::if_compatible_char<Char> = true> QUtf8StringView::QUtf8StringView(const Char *str, qsizetype len)

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

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

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

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

이 생성자는 Char 가 호환되는 문자 유형인 경우에만 과부하 해결에 참여합니다. 호환되는 문자 유형은 char8_t, char, signed char 및 unsigned char 입니다.

[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

문자열 보기에서 첫 번째 코드 포인트를 가리키는 상수 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()도 참조하세요 .

[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

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

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

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

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

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

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

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::end() 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, QUtf8StringView::if_compatible_char<Char> = true> QUtf8StringView QUtf8StringView::fromArray(const Char (&)[Size] string)

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

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 스타일 리버스 이터레이터를 반환합니다.

이 함수는 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 코드 포인트로 반환합니다(즉, 멀티바이트 시퀀스는 이 함수의 목적상 둘 이상으로 간주되며 QString 및 QStringView 의 대리 쌍과 동일합니다).

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

위치 pos 에서 시작하는 이 문자열 보기의 n 코드 포인트를 포함하는 문자열 보기를 반환합니다.

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

QString QUtf8StringView::toString() const

이 문자열 뷰 데이터의 심층 복사본을 QString 로 반환합니다.

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

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

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

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

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

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

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

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

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

[noexcept, since 6.7] std::basic_string_view<QUtf8StringView::storage_type> QUtf8StringView::operator std::basic_string_view<QUtf8StringView::storage_type>() const

이 QUtf8StringView 객체를 std::basic_string_view 객체로 변환합니다. 반환된 뷰는 이 뷰와 동일한 데이터 포인터와 길이를 갖습니다. 반환된 뷰의 문자 유형은 storage_type 입니다.

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

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

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

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

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