QUtf8StringView Class

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

Dokumentation zu den Mitgliedsfunktionen

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

Erstellt eine Null-String-Ansicht.

Siehe auch ` isNull()`.

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

Erstellt eine String-Ansicht für das Zeichenfolgenliteral „ string “. Die Ansicht deckt das Array ab, bis entweder das erste „ Char(0) “ oder „ N “ auftritt – je nachdem, was zuerst eintritt. Wenn Sie das gesamte Array benötigen, verwenden Sie stattdessen „ fromArray()“.

string muss während der gesamten Lebensdauer dieses String-View-Objekts gültig bleiben.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn „ string “ ein tatsächliches Array ist und „ Char “ ein kompatibler Zeichentyp ist. Die kompatiblen Zeichentypen sind: „ char8_t “, „ char “, „ signed char “ und „ unsigned char “.

Siehe auch fromArray().

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

Erstellt eine String-Ansicht auf str. Die Länge wird durch das Durchsuchen nach dem ersten Char(0) ermittelt.

str muss während der gesamten Lebensdauer dieses String-View-Objekts gültig bleiben.

Die Übergabe von ` nullptr ` als ` str ` ist unbedenklich und führt zu einer leeren String-Ansicht.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn „ str “ kein Array ist und „ Char “ ein kompatibler Zeichentyp ist. Die kompatiblen Zeichentypen sind: „ char8_t “, „ char “, „ signed char “ und „ unsigned char “.

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

Erstellt eine String-Ansicht auf der Grundlage von str. Die Länge wird von std::size(str) übernommen.

std::data(str) muss während der gesamten Lebensdauer dieses String-View-Objekts gültig bleiben.

Die Zeichenfolgenansicht ist genau dann leer, wenn std::size(str) == 0 gilt. Es ist nicht festgelegt, ob dieser Konstruktor zu einer leeren Zeichenfolgenansicht führen kann (dazu müsstestd::data(str) den Wert nullptr zurückgeben).

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn „ Container “ ein Container mit einem mit „ value_type “ kompatiblen Zeichentyp ist. Die kompatiblen Zeichentypen sind: „ char8_t “, „ char “, „ signed char “ und „ unsigned char “.

Siehe auch „ isNull()“ und „ isEmpty()“.

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

Erstellt eine Null-String-Ansicht.

Siehe auch ` isNull()`.

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

Erstellt eine String-Ansicht auf first mit der Länge (last – first).

Der Bereich [first,last) muss während der gesamten Lebensdauer dieses String-View-Objekts gültig bleiben.

Die Übergabe von ` \nullptr ` als ` first ` ist sicher, wenn ` last ` ebenfalls ` nullptr` ist, und führt zu einer leeren String-View.

Das Verhalten ist undefiniert, wenn „ last “ vor „ first “ steht oder wenn „ first “ gleich „ nullptr “ ist, „ last “ jedoch nicht.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn „ Char “ ein kompatibler Zeichentyp ist. Die kompatiblen Zeichentypen sind: „ char8_t “, „ char “, „ signed char “ und „ unsigned char “.

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

Erstellt eine String-Ansicht auf str mit der Länge len.

Der Bereich [str,len) muss während der gesamten Lebensdauer dieses String-View-Objekts gültig bleiben.

Die Übergabe von ` nullptr ` als ` str ` ist sicher, wenn ` len ` ebenfalls 0 ist, und führt zu einer leeren Zeichenfolgenansicht.

Das Verhalten ist undefiniert, wenn „ len “ negativ ist oder, falls positiv, wenn „ str “ gleich „ nullptr “ ist.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn Char ein kompatibler Zeichentyp ist. Die kompatiblen Zeichentypen sind: char8_t, char, signed char und unsigned char.

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

Ersetzt alle Vorkommen von „ %N “ in dieser Zeichenkette durch das entsprechende Argument aus „ args “. Die Argumente sind nicht positionsabhängig: Das erste Argument aus „ args “ ersetzt „ %N “ durch den niedrigsten Wert aus „ N “ (alle), das zweite Argument aus „ args “ ersetzt „ %N “ durch den nächstniedrigeren Wert aus „ N “ usw.

Args kann aus allem bestehen, das implizit in ` QAnyStringView` konvertiert werden kann.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ QString::arg“ (Args&&...).

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

Gibt den Codepunkt an der Position n in dieser Zeichenfolgenansicht zurück.

Das Verhalten ist undefiniert, wenn ` n ` negativ ist oder größer oder gleich ` size()` ist.

Siehe auch operator[](), front() und back().

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

Gibt den letzten Codepunkt in der Zeichenfolgenansicht zurück. Entspricht „ last()“.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch „ front()“.

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

Gibt einen konstanten Iterator im STL-Stil zurück, der auf den ersten Codepunkt in der Zeichenfolgenansicht zeigt.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch end(), cbegin(), rbegin() und data().

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

Entspricht „ begin()“.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch cend(), begin(), crbegin() und data().

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

Entspricht „ end()“.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch cbegin(), end() und crend().

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

Kürzt diese Zeichenfolgenansicht um n Codepunkte.

Entspricht ` *this = first(size() - n)`.

Siehe auch „ sliced()“, „ first()“, „ last()“, „ chopped()“ und „ truncate()“.

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

Gibt die Teilzeichenfolge der Länge „ size()“ – „ n “ zurück, beginnend am Anfang dieses Objekts.

Entspricht first(size() - n).

Siehe auch „ sliced()“, „ first()“, „ last()“, „ chop()“, „ truncate()“ und „ slice()“.

Vergleicht diese Zeichenfolgenansicht mit str und gibt eine negative ganze Zahl zurück, wenn diese Zeichenfolgenansicht kleiner als str ist, eine positive ganze Zahl, wenn sie größer als str ist, und Null, wenn sie gleich sind.

Ist cs gleich Qt::CaseSensitive (Standard), erfolgt der Vergleich unter Berücksichtigung der Groß-/Kleinschreibung; andernfalls erfolgt der Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung.

Diese Funktionen wurden in Qt 6.5 eingeführt.

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

Entspricht „ rbegin()“.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch crend(), rbegin() und cbegin().

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

Entspricht ` rend()`.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch crbegin(), rend() und cend().

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

Gibt einen const-Zeiger auf den ersten Codepunkt in der Zeichenfolgenansicht zurück.

Siehe auch „ begin()“, „ end()“ und „ utf8()“.

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

Gibt zurück, ob diese Zeichenfolgenansicht leer ist – das heißt, ob „ size() == 0 “ gilt.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch isEmpty(), isNull(), size() und length().

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

Gibt einen konstanten Iterator im STL-Stil zurück, der auf den imaginären Codepunkt nach dem letzten Codepunkt in der Liste verweist.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch begin(), cend() und rend().

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

Gibt eine Zeichenfolgenansicht zurück, die die ersten n Codepunkte dieser Zeichenfolgenansicht enthält.

Siehe auch „ last()“, „ sliced()“, „ chopped()“, „ chop()“, „ truncate()“ und „ slice()“.

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

Erstellt eine String-Ansicht des vollständigen Zeichenfolgenliterals „ string “ aus „ Size “-Elementen, einschließlich aller nachgestellten „ Char(0) “. Wenn Sie nicht möchten, dass der Null-Terminator in der Ansicht enthalten ist, können Sie ihn mit „ chop()“ entfernen, sobald Sie sicher sind, dass er am Ende steht. Alternativ können Sie die Konstruktorüberladung verwenden, die ein Array-Literal akzeptiert und eine Ansicht bis zum ersten Null-Terminator in den Daten (ohne diesen) erstellt.

string muss für die gesamte Lebensdauer dieses String-View-Objekts gültig bleiben.

Diese Funktion funktioniert mit jedem Array-Literal, sofern „ Char “ ein kompatibler Zeichentyp ist. Die kompatiblen Zeichentypen sind: „ char8_t “, „ char “, „ signed char “ und „ unsigned char “.

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

Gibt den ersten Codepunkt in der Zeichenfolgenansicht zurück. Entspricht „ first()“.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch ` back()`.

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

Gibt zurück, ob diese String-Ansicht leer ist – das heißt, ob size() == 0 gilt.

Diese Funktion wird aus Gründen der Kompatibilität mit anderen Qt-Containern bereitgestellt.

Siehe auch empty(), isNull(), size() und length().

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

Gibt zurück, ob diese String-Ansicht null ist – das heißt, ob ` data() == nullptr` gilt.

Diese Funktion wird aus Gründen der Kompatibilität mit anderen Qt-Containern bereitgestellt.

Siehe auch empty(), isEmpty(), size() und length().

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

Gibt „ true “ zurück, wenn diese Zeichenkette gültige, UTF-8-kodierte Daten enthält, andernfalls „ false “.

Diese Funktion wurde in Qt 6.3 eingeführt.

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

Gibt eine Zeichenfolgenansicht zurück, die die letzten n Codepunkte dieser Zeichenfolgenansicht enthält.

Siehe auch „ first()“, „ sliced()“, „ chopped()“, „ chop()“, „ truncate()“ und „ slice()“.

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

Entspricht „ size()“.

Diese Funktion wird aus Gründen der Kompatibilität mit anderen Qt-Containern bereitgestellt.

Siehe auch empty(), isEmpty(), isNull() und size().

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

Sie gibt die maximale Anzahl von Elementen zurück, die die Ansicht theoretisch darstellen kann. In der Praxis kann diese Zahl jedoch deutlich geringer ausfallen, da sie durch den dem System zur Verfügung stehenden Speicher begrenzt ist.

Diese Funktion wurde in Qt 6.8 eingeführt.

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

Diese Funktion dient der STL-Kompatibilität.

Gibt ` maxSize()` zurück.

Diese Funktion wurde in Qt 6.8 eingeführt.

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

Gibt einen konstanten Reverse-Iterator im STL-Stil zurück, der auf den ersten Codepunkt in der Zeichenfolgenansicht in umgekehrter Reihenfolge verweist.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch rend(), crbegin() und begin().

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

Gibt einen Reverse-Iterator im STL-Stil zurück, der in umgekehrter Reihenfolge auf die Position nach dem letzten Codepunkt in der Zeichenfolgenansicht zeigt.

Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Siehe auch rbegin(), crend() und end().

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

Gibt die Größe dieser String-Ansicht in UTF-8-Codepunkten zurück (das heißt, Multibyte-Sequenzen werden für die Zwecke dieser Funktion als mehr als ein Codepunkt gezählt, genau wie Surrogatpaare in QString und QStringView).

Siehe auch empty(), isEmpty(), isNull() und length().

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

Passen Sie diese Zeichenfolgenansicht so an, dass sie an der Position pos beginnt und sich über n Codepunkte erstreckt.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch sliced(), first(), last(), chopped(), chop() und truncate().

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

Passen Sie diese Zeichenfolgenansicht so an, dass sie an der Position pos beginnt und sich bis zum Ende erstreckt.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch „ sliced()“, „ first()“, „ last()“, „ chopped()“, „ chop()“ und „ truncate()“.

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

Gibt eine String-Ansicht zurück, die an der Position „ pos “ in diesem Objekt beginnt und bis zum Ende desselben reicht.

Siehe auch first(), last(), chopped(), chop(), truncate() und slice().

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

Gibt eine String-Ansicht zurück, die die Code-Punkte „ n “ dieser String-Ansicht enthält, beginnend an der Position „ pos “.

Siehe auch first(), last(), chopped(), chop(), truncate() und slice().

QString QUtf8StringView::toString() const

Gibt eine tiefe Kopie der Daten dieser String-Ansicht als ` QString` zurück.

Der Rückgabewert ist genau dann ein ` QString ` vom Typ `null`, wenn diese String-Ansicht `null` ist.

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

Kürzt diese Zeichenfolgenansicht auf n Code-Punkte.

Entspricht „ *this = first(n) “.

Siehe auch „ sliced()“, „ first()“, „ last()“, „ chopped()“ und „ chop()“.

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

Gibt einen const-Zeiger auf den ersten Codepunkt in der Zeichenfolgenansicht zurück.

Das Ergebnis wird als ` const char8_t*` zurückgegeben, daher ist diese Funktion nur bei der Kompilierung im C++20-Modus verfügbar.

Siehe auch ` begin()`, ` end()` und ` data()`.

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

Wandelt dieses „ QUtf8StringView “-Objekt in ein „ std::string_view “-Objekt um. Die zurückgegebene Ansicht hat denselben Datenzeiger und dieselbe Länge wie diese Ansicht.

Diese Funktion wurde in Qt 6.7 eingeführt.

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

Wandelt dieses „ QUtf8StringView “-Objekt in ein „ std::u8string_view “-Objekt um. Die zurückgegebene Ansicht hat denselben Datenzeiger und dieselbe Länge wie diese Ansicht.

Diese Funktion ist nur bei der Kompilierung im C++20-Modus verfügbar.

Diese Funktion wurde in Qt 6.10 eingeführt.

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

Gibt den Codepunkt an der Position n in dieser Zeichenfolgenansicht zurück.

Das Verhalten ist undefiniert, wenn ` n ` negativ ist oder nicht kleiner als ` size()` ist.

Siehe auch at(), front() und back().