QAnyStringView Class

멤버 함수 문서

[constexpr noexcept] QAnyStringView::QAnyStringView()

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

isNull()도 참조하세요 .

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

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

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

이 생성자는 string 가 실제 배열이고 Char 가 호환되는 문자 유형인 경우에만 과부하 해결에 참여합니다.

Compatible Character Types 를참조하세요 .

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

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

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

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

이 생성자는 str 이 배열이 아니고 Char 이 호환 가능한 문자 유형인 경우에만 과부하 해결에 참여합니다.

isNull() 및 Compatible Character Types도 참조하세요 .

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

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

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

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

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

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

[noexcept] QAnyStringView::QAnyStringView(const QByteArray &str)

str 에 문자열 뷰를 작성합니다. str 의 데이터는 UTF-8로 해석됩니다.

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

문자열 뷰는 str.isNull().

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

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

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

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

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

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

isNull()도 참조하세요 .

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

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

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

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

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

이 생성자는 Char 가 호환되는 문자 유형인 경우에만 과부하 해결에 참여합니다.

isNull() 및 Compatible Character Types도 참조하세요 .

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

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

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

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

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

이 생성자는 Char 이 호환 가능한 문자 유형인 경우에만 과부하 해결에 참여합니다.

isNull() 및 Compatible Character Types도 참조하세요 .

[constexpr] QChar QAnyStringView::back() const

문자열 보기의 마지막 문자를 반환합니다.

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

front() 및 Sizes and Sub-Strings 을참조하세요 .

[constexpr, since 6.5] void QAnyStringView::chop(qsizetype n)

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

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

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

sliced(), first(), last(), chopped(), truncate(), slice() 및 Sizes and Sub-Strings 을참조하십시오 .

[constexpr, since 6.5] QAnyStringView QAnyStringView::chopped(qsizetype n) const

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

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

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

sliced(), first(), last(), chop(), truncate(), slice() 및 Sizes and Sub-Strings 을참조하십시오 .

[static noexcept] int QAnyStringView::compare(QAnyStringView lhs, QAnyStringView rhs, Qt::CaseSensitivity cs = Qt::CaseSensitive)

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

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

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

[constexpr noexcept] const void *QAnyStringView::data() const

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

size_bytes()도 참조하세요 .

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

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

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

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

[constexpr, since 6.5] QAnyStringView QAnyStringView::first(qsizetype n) const

이 문자열 보기의 첫 번째 n 코드 포인트가 포함된 문자열 보기를 반환합니다.

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

last(), sliced(), chopped(), chop(), truncate(), slice() 및 Sizes and Sub-Strings 을참조하십시오 .

[constexpr] QChar QAnyStringView::front() const

문자열 보기에서 첫 번째 문자를 반환합니다.

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

back() 및 Sizes and Sub-Strings 을참조하세요 .

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

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

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

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

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

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

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

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

[constexpr, since 6.5] QAnyStringView QAnyStringView::last(qsizetype n) const

이 문자열 보기의 마지막 n 코드 포인트가 포함된 문자열 보기를 반환합니다.

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

first(), sliced(), chopped(), chop(), truncate(), slice() 및 Sizes and Sub-Strings 을참조하십시오 .

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

size()와 동일합니다.

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

size()도 참조하십시오 .

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

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

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

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

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

이 문자열 보기의 크기를 인코딩의 코드 포인트로 반환합니다.

empty(), isEmpty(), isNull(), size_bytes() 및 Sizes and Sub-Strings 를참조하세요 .

[constexpr noexcept] qsizetype QAnyStringView::size_bytes() const

이 문자열 보기의 크기를 반환하지만 코드 포인트가 아닌 바이트 단위로 반환합니다.

이 함수는 해싱 또는 직렬화를 위해 data()와 함께 사용할 수 있습니다.

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

size() 및 data()도 참조하세요 .

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

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

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

sliced(), first(), last(), chopped(), chop(), truncate() 및 Sizes and Sub-Strings 을참조하십시오 .

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

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

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

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

sliced(), first(), last(), chopped(), chop(), truncate() 및 Sizes and Sub-Strings 을참조하십시오 .

[constexpr, since 6.5] QAnyStringView QAnyStringView::sliced(qsizetype pos) const

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

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

first(), last(), chopped(), chop(), truncate(), slice() 및 Sizes and Sub-Strings 을참조하십시오 .

[constexpr, since 6.5] QAnyStringView QAnyStringView::sliced(qsizetype pos, qsizetype n) const

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

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

first(), last(), chopped(), chop(), truncate(), slice() 및 Sizes and Sub-Strings 을참조하십시오 .

QString QAnyStringView::toString() const

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

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

[constexpr, since 6.5] void QAnyStringView::truncate(qsizetype n)

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

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

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

sliced(), first(), last(), chopped(), chop() 및 Sizes and Sub-Strings 를참조하십시오 .

[constexpr] template <typename Visitor> decltype(auto) QAnyStringView::visit(Visitor &&v) const

이 문자열 보기가 참조하는 문자열 데이터의 인코딩에 따라 QUtf8StringView, QLatin1String 또는 QStringView 을 사용하여 v 을 호출합니다.

이것이 QAnyStringView 을 받는 대부분의 함수가 인코딩별 함수로 분기하는 방식입니다:

void processImpl(QLatin1String s) { ~~~ }
void processImpl(QUtf8StringView s) { ~~~ }
void processImpl(QStringView s) { ~~~ }

void process(QAnyStringView s)
{
    s.visit([](auto s) { processImpl(s); });
}

여기서는 QAnyStringView 객체와 람다의 매개변수 모두에 동일한 이름인 s 을 재사용하고 있습니다. 이는 관용적 코드이며 다음과 같이 더 복잡한 상황에서 방문() 호출을 통해 객체의 신원을 추적하는 데 도움이 됩니다.

bool equal(QAnyStringView lhs, QAnyStringView rhs)
{
    // assuming operator==(QAnyStringView, QAnyStringView) didn't, yet, exist:
    return lhs.visit([rhs](auto lhs) {
        rhs.visit([lhs](auto rhs) {
            return lhs == rhs;
        });
    });
}

visit()를 사용하려면 모든 람다 인스턴스의 반환 유형이 동일해야 합니다. 유형이 다르면 공통 유형이 있더라도 컴파일 오류가 발생합니다. 이 문제를 해결하려면 람다에 명시적 반환 유형을 사용하거나 반환 문에서 형 변환을 하면 됩니다:

// wrong:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {   // ERROR: lambdas return different types
        return input.sliced(0, input.size() / 2);
    });
}
// correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) -> QAnyStringView { // OK, explicit return type
        return input.sliced(0, input.size() / 2);
    });
}
// also correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {
        return QAnyStringView(input.sliced(0, input.size() / 2)); // OK, cast to common type
    });
}