QAnyStringView Class

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] QAnyStringView::QAnyStringView()

Konstruiert eine Null-String-Ansicht.

Siehe auch isNull().

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

Konstruiert eine Zeichenkettenansicht für das Zeichenfolgenliteral string. Die Ansicht deckt das Array ab, bis das erste Char(0) gefunden wird, oder N, je nachdem, was zuerst eintritt. Wenn Sie das gesamte Array benötigen, verwenden Sie stattdessen fromArray().

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

Dieser Konstruktor nimmt nur an der Überladungsauflösung teil, wenn string ein tatsächliches Array ist und Char ein kompatibler Zeichentyp ist.

Siehe auch Compatible Character Types.

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

Konstruiert eine String-Ansicht auf str. Die Länge wird durch die Suche nach dem ersten Char(0) bestimmt.

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

Die Übergabe von nullptr als str ist sicher und führt zu einer Null-String-Ansicht.

Dieser Konstruktor nimmt nur an der Überladungsauflösung teil, wenn str kein Array ist und wenn Char ein kompatibler Zeichentyp ist.

Siehe auch isNull() und Compatible Character Types.

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

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

std::data(str) muss für die Lebensdauer dieses String-View-Objekts gültig bleiben.

Dieser Konstruktor nimmt nur an der Überlastauflösung teil, wenn Container ein Container mit einem kompatiblen Zeichentyp wie value_type ist.

Die String-Ansicht ist leer, wenn und nur wenn std::size(str) == 0. Es ist nicht spezifiziert, ob dieser Konstruktor zu einer Null-String-Ansicht führen kann (std::data(str) müsste dazu nullptr zurückgeben).

Siehe auch isNull() und isEmpty().

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

Konstruiert eine String-Ansicht auf str. Die Daten in str werden als UTF-8 interpretiert.

str.data() muss während der Lebensdauer dieses Objekts gültig bleiben.

Die Zeichenkettenansicht ist null, wenn und nur wenn str.isNull().

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

Konstruiert eine String-Ansicht auf str.

str.data() muss während der Lebensdauer dieses Objekts gültig bleiben.

Die String-Ansicht ist null, wenn und nur wenn str.isNull().

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

Konstruiert eine Null-String-Ansicht.

Siehe auch isNull().

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

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

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

Die Übergabe von nullptr als first ist sicher, wenn last auch nullptr ist, und führt zu einer Null-String-Ansicht.

Das Verhalten ist undefiniert, wenn last vor first steht, oder first ist nullptr und last nicht.

Dieser Konstruktor nimmt nur an der Überlastauflösung teil, wenn Char ein kompatibler Zeichentyp ist.

Siehe auch isNull() und Compatible Character Types.

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

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

Der Bereich [str,len) muss während der 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 Null-String-Ansicht.

Das Verhalten ist undefiniert, wenn len negativ ist oder, wenn positiv, wenn str nullptr ist.

Dieser Konstruktor nimmt nur an der Überlastauflösung teil, wenn Char ein kompatibler Zeichentyp ist.

Siehe auch isNull() und Compatible Character Types.

[constexpr] QChar QAnyStringView::back() const

Gibt das letzte Zeichen in der Zeichenkettenansicht zurück.

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen.

Siehe auch front() und Sizes and Sub-Strings.

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

Schneidet diese Zeichenkettenansicht um n Codepunkte ab.

Dasselbe wie *this = first(size() - n).

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch sliced(), first(), last(), chopped(), truncate(), slice(), und Sizes and Sub-Strings.

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

Gibt die Teilzeichenkette der Länge size() - n zurück, die am Anfang dieses Objekts beginnt.

Dasselbe wie first(size() - n).

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch sliced(), first(), last(), chop(), truncate(), slice(), und Sizes and Sub-Strings.

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

Vergleicht die Zeichenkettenansicht lhs mit der Zeichenkettenansicht rhs und gibt eine negative Ganzzahl zurück, wenn lhs kleiner als rhs ist, eine positive Ganzzahl, wenn sie größer als rhs ist, und Null, wenn sie gleich sind.

Wenn cs gleich Qt::CaseSensitive ist (Standardeinstellung), wird beim Vergleich zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird die Groß- und Kleinschreibung nicht berücksichtigt.

Siehe auch operator==(), operator<(), und operator>().

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

Gibt einen Konstantenzeiger auf das erste Zeichen in der Zeichenkettenansicht zurück.

Siehe auch size_bytes().

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

Gibt zurück, ob diese String-Ansicht leer ist, d. h. ob size() == 0.

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

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

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

Gibt eine String-Ansicht zurück, die die ersten n Codepunkte dieser String-Ansicht enthält.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch last(), sliced(), chopped(), chop(), truncate(), slice(), und Sizes and Sub-Strings.

[constexpr] QChar QAnyStringView::front() const

Gibt das erste Zeichen in der Zeichenkettenansicht zurück.

Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen.

Siehe auch back() und Sizes and Sub-Strings.

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

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

Diese Funktion ist für die Kompatibilität mit anderen Qt-Containern vorgesehen.

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

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

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

Diese Funktion ist für die Kompatibilität mit anderen Qt-Containern vorgesehen.

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

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

Gibt eine String-Ansicht zurück, die die letzten n Codepunkte dieser String-Ansicht enthält.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch first(), sliced(), chopped(), chop(), truncate(), slice(), und Sizes and Sub-Strings.

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

Dasselbe wie size().

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

Siehe auch size().

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

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

Sie gibt die maximale Anzahl von Elementen zurück, die die String-Ansicht theoretisch darstellen kann. In der Praxis kann die Anzahl viel kleiner sein, da sie durch den dem System zur Verfügung stehenden Speicher begrenzt ist.

Diese Funktion wurde in Qt 6.8 eingeführt.

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

Gibt die Größe dieser Zeichenkettenansicht in den Codepunkten der Kodierung zurück.

Siehe auch empty(), isEmpty(), isNull(), size_bytes(), und Sizes and Sub-Strings.

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

Gibt die Größe dieser Zeichenkettenansicht zurück, jedoch in Bytes, nicht in Code-Punkten.

Sie können diese Funktion zusammen mit data() für Hashing oder Serialisierung verwenden.

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

Siehe auch size() und data().

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

Ändert diese Zeichenkettenansicht so, dass sie an der Position pos beginnt und um die Codepunkte n erweitert wird.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch sliced(), first(), last(), chopped(), chop(), truncate(), und Sizes and Sub-Strings.

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

Dies ist eine überladene Funktion.

Ändert diese Zeichenkettenansicht so, dass sie an der Position pos beginnt und bis zu ihrem Ende reicht.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch sliced(), first(), last(), chopped(), chop(), truncate(), und Sizes and Sub-Strings.

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

Gibt eine Zeichenkettenansicht zurück, die an der Position pos in diesem Objekt beginnt und bis zu dessen Ende reicht.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch first(), last(), chopped(), chop(), truncate(), slice(), und Sizes and Sub-Strings.

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

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

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch first(), last(), chopped(), chop(), truncate(), slice(), und Sizes and Sub-Strings.

QString QAnyStringView::toString() const

Gibt eine tiefe Kopie der Daten dieser Zeichenfolgenansicht als QString zurück.

Der Rückgabewert ist null QString, wenn und nur wenn diese String-Ansicht null ist.

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

Kürzt diese Zeichenkettenansicht auf n Codepunkte ab.

Dasselbe wie *this = first(n).

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch sliced(), first(), last(), chopped(), chop(), und Sizes and Sub-Strings.

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

Ruft v entweder mit QUtf8StringView, QLatin1String oder QStringView auf, abhängig von der Kodierung der Zeichenkettendaten, auf die diese Zeichenkettenansicht verweist.

Auf diese Weise verzweigen sich die meisten Funktionen, die QAnyStringView verwenden, in Funktionen für einzelne Kodierungen:

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

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

Hier verwenden wir denselben Namen, s, sowohl für das Objekt QAnyStringView als auch für den Parameter des Lambdas. Dies ist idiomatischer Code und hilft, die Identität der Objekte durch visit()-Aufrufe zu verfolgen, zum Beispiel in komplexeren Situationen wie

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() erfordert, dass alle Lambda-Instanziierungen denselben Rückgabetyp haben. Wenn sie sich unterscheiden, erhalten Sie einen Kompilierfehler, selbst wenn es einen gemeinsamen Typ gibt. Um dies zu beheben, können Sie explizite Rückgabetypen für das Lambda verwenden oder in den Rückgabeanweisungen casten:

// 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
    });
}