Auf dieser Seite

QStringRef Class

Die Klasse `QStringRef` stellt eine schlanke Hülle für Teilzeichenfolgen vom Typ ` QString ` bereit. Mehr...

Header: #include <QStringRef>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat

Hinweis: Alle Funktionen dieser Klasse sind reentrant.

Öffentliche Typen

Öffentliche Funktionen

QStringRef()
QStringRef(const QString *string)
QStringRef(const QString *string, qsizetype position, qsizetype length)
QStringRef(const QStringRef &other)
~QStringRef()
QStringRef appendTo(QString *string) const
const QChar at(int position) const
QChar back() const
QStringRef::const_iterator begin() const
QStringRef::const_iterator cbegin() const
QStringRef::const_iterator cend() const
void chop(int n)
QStringRef chopped(int len) const
void clear()
int compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QByteArray &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QStringRef &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef::const_iterator constBegin() const
const QChar *constData() const
QStringRef::const_iterator constEnd() const
bool contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count() const
int count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef::const_reverse_iterator crbegin() const
QStringRef::const_reverse_iterator crend() const
const QChar *data() const
QStringRef::const_iterator end() const
bool endsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QChar front() const
int indexOf(QLatin1String str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(const QString &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(QStringView str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(const QStringRef &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool isEmpty() const
bool isNull() const
bool isRightToLeft() const
int lastIndexOf(const QString &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QLatin1String str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QStringView str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(const QStringRef &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef left(int n) const
int length() const
int localeAwareCompare(const QString &other) const
int localeAwareCompare(const QStringRef &other) const
QStringRef mid(int position, int n = -1) const
int position() const
QStringRef::const_reverse_iterator rbegin() const
QStringRef::const_reverse_iterator rend() const
QStringRef right(int n) const
int size() const
QList<QStringRef> split(const QString &sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QList<QStringRef> split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
const QString *string() const
double toDouble(bool *ok = nullptr) const
float toFloat(bool *ok = nullptr) const
int toInt(bool *ok = nullptr, int base = 10) const
QByteArray toLatin1() const
QByteArray toLocal8Bit() const
long toLong(bool *ok = nullptr, int base = 10) const
qlonglong toLongLong(bool *ok = nullptr, int base = 10) const
short toShort(bool *ok = nullptr, int base = 10) const
QString toString() const
uint toUInt(bool *ok = nullptr, int base = 10) const
ulong toULong(bool *ok = nullptr, int base = 10) const
qulonglong toULongLong(bool *ok = nullptr, int base = 10) const
ushort toUShort(bool *ok = nullptr, int base = 10) const
QList<uint> toUcs4() const
QByteArray toUtf8() const
QStringRef trimmed() const
void truncate(int position)
const QChar *unicode() const
bool operator!=(const char *s) const
bool operator<(const char *s) const
bool operator<=(const char *s) const
QStringRef &operator=(const QString *string)
QStringRef &operator=(const QStringRef &other)
bool operator==(const char *s) const
bool operator>(const char *s) const
bool operator>=(const char *s) const
QChar operator[](int position) const

Statische öffentliche Mitglieder

int compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int localeAwareCompare(const QStringRef &s1, const QString &s2)
int localeAwareCompare(const QStringRef &s1, const QStringRef &s2)
bool operator<(const QStringRef &s1, const QStringRef &s2)
bool operator<=(const QStringRef &s1, const QStringRef &s2)
bool operator==(QLatin1String s1, const QStringRef &s2)
bool operator==(const QString &s1, const QStringRef &s2)
bool operator==(const QStringRef &s1, const QStringRef &s2)
bool operator>(const QStringRef &s1, const QStringRef &s2)
bool operator>=(const QStringRef &s1, const QStringRef &s2)

Ausführliche Beschreibung

QStringRef stellt eine schreibgeschützte Teilmenge der „ QString “-API bereit.

Eine String-Referenz verweist explizit auf einen Teil einer ` string()` mit einem bestimmten ` size()`, beginnend bei einem bestimmten ` position()`. Der Aufruf von ` toString()` gibt eine Kopie der Daten als echte ` QString `-Instanz zurück.

Diese Klasse wurde entwickelt, um die Leistung bei der Verarbeitung von Teilzeichenfolgen zu verbessern, die aus bestehenden QString -Instanzen gewonnen wurden. QStringRef vermeidet den Overhead durch Speicherzuweisung und Referenzzählung eines Standard- QString, indem es einfach auf einen Teil der ursprünglichen Zeichenkette verweist. Dies kann sich in Low-Level-Code, wie er beispielsweise in einem Parser verwendet wird, als vorteilhaft erweisen, geht jedoch auf Kosten eines potenziell komplexeren Codes.

Für die meisten Anwender bietet die Verwendung von QStringRef anstelle von ` QString ` keine semantischen Vorteile, da QStringRef die Berücksichtigung von Speicherverwaltungsaspekten erfordert, was das Schreiben und Warten des Codes potenziell komplexer macht.

Warnung: Ein `QStringRef` ist nur so lange gültig, wie die referenzierte Zeichenkette existiert. Wird die ursprüngliche Zeichenkette gelöscht, verweist die Zeichenkettenreferenz auf einen ungültigen Speicherort.

Wir empfehlen, diese Klasse nur in stabilem Code zu verwenden, bei dem durch Profiling eindeutig festgestellt wurde, dass sich Leistungsverbesserungen erzielen lassen, indem Standard-Zeichenfolgenoperationen durch die von dieser Klasse bereitgestellte optimierte Teilzeichenfolgenverarbeitung ersetzt werden.

Sicherheitshinweise

Diese Klasse verwendet „ int “, um die Werte von „ size()“ und „ position()“ zu speichern. Daher kann sie keine Teile von Zeichenketten darstellen, die länger als „ INT_MAX “ sind oder bei einem größeren Offset beginnen. Der Versuch, auf solche Teile zuzugreifen, führt zu undefiniertem Verhalten. Beachten Sie, dass auch die Erstellung von `QStringRef` aus ` QString ` betroffen ist, wenn die Größe von ` QString` den Wert ` INT_MAX` überschreitet, selbst wenn keine expliziten Größen übergeben werden.

Verwenden Sie stattdessen „ QStringView “ und beachten Sie dabei, dass dessen Besitzmodell lockerer ist als das von „QStringRefs“. Weitere Details finden Sie im Portierungsleitfaden.

Siehe auch „Implizit gemeinsam genutzte Klassen“.

Dokumentation zu Mitgliedstypen

QStringRef::const_iterator

Siehe auch QStringRef::const_reverse_iterator.

QStringRef::const_reverse_iterator

Siehe auch QStringRef::const_iterator.

Dokumentation zu Mitgliedsfunktionen

[constexpr noexcept] QStringRef::QStringRef()

Erstellt eine Referenz auf eine leere Zeichenkette.

QStringRef::QStringRef(const QString *string)

Erstellt eine String-Referenz auf den angegebenen ` string`.

Warnung: QStringRef verwendet „ int “ (32 Bit) zur Darstellung seines „ size “ (). In Qt 6 wird die Größe von „ QString “ als „ qsizetype “ dargestellt, was bei 64-Bit-Builds 64 Bit entspricht. Stellen Sie sicher, dass die Größe der Eingabe in 32 Bit passt, andernfalls wird „ the behavior is undefined “ ausgegeben.

QStringRef::QStringRef(const QString *string, qsizetype position, qsizetype length)

Erstellt eine Zeichenfolgenreferenz auf den Zeichenbereich im angegebenen „ string “, der durch den Startwert „ position “ und den Endwert „ length “ in Zeichen angegeben wird.

Warnung: Diese Funktion dient der größtmöglichen Leistungsoptimierung und führt keine Bereichsprüfung durch. Um die Korrektheit des Programms zu gewährleisten, müssen position und length eine gültige Teilzeichenkette von string beschreiben und in int darstellbar sein.

Das bedeutet, dass der Startwert position positiv oder 0 sein und kleiner als die Länge von string sein muss, und dass length positiv oder 0 sein muss, aber kleiner als die Länge der Zeichenkette abzüglich des Startwerts position; d. h., es müssen beide Bedingungen erfüllt sein: 0 <= position < string->length() und 0 <= length <= string->length() - position.

Warnung: Ab Qt 6.12 akzeptiert dieser Konstruktor die Werte „ qsizetype “, „ position “ und „ length “ anstelle von „ int “. Dies verhindert eine stillschweigende Typverengung an der Aufrufstelle. Die Übergabe von Werten, die nicht in „ int “ dargestellt werden können, führt jedoch weiterhin zu „ undefined behavior “.

[implicit] QStringRef::QStringRef(const QStringRef &other)

Erstellt eine Kopie der Zeichenfolgenreferenz „ other “.

[noexcept implicit] QStringRef::~QStringRef()

Löscht die Zeichenfolgenreferenz.

Da diese Klasse lediglich dazu dient, auf Zeichenfolgen-Daten zu verweisen, und diese nicht in ihren Besitz übernimmt, wird beim Löschen von Instanzen kein Speicher freigegeben.

QStringRef QStringRef::appendTo(QString *string) const

Fügt die Zeichenfolgenreferenz an „ string “ an und gibt eine neue Referenz auf die zusammengefügten Zeichenfolgendaten zurück.

const QChar QStringRef::at(int position) const

Gibt das Zeichen an der angegebenen Indexposition position in der Zeichenfolgenreferenz zurück.

Der position muss eine gültige Indexposition in der Zeichenkette sein (d. h., 0 <= position < size()).

QChar QStringRef::back() const

Gibt das letzte Zeichen der Zeichenkette zurück. Entspricht „ at(size() - 1) “.

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

Warnung: Der Aufruf dieser Funktion für eine leere Zeichenkette führt zu undefiniertem Verhalten.

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

QStringRef::const_iterator QStringRef::begin() const

Gibt einen konstanten Iterator im STL-Stil zurück, der auf das erste Zeichen der Zeichenkette zeigt.

Siehe auch cbegin(), constBegin(), end(), constEnd(), rbegin() und rend().

QStringRef::const_iterator QStringRef::cbegin() const

Wie unter begin() beschrieben.

Siehe auch begin(), constBegin(), cend(), constEnd(), rbegin() und rend().

QStringRef::const_iterator QStringRef::cend() const

Wie unter end() beschrieben.

Siehe auch end(), constEnd(), cbegin(), constBegin(), rbegin() und rend().

[noexcept] void QStringRef::chop(int n)

Entfernt die Zeichen „ n “ vom Ende der Zeichenkette.

Ist ` n ` größer oder gleich ` size()`, ist das Ergebnis eine leere Zeichenkette; ist ` n ` negativ, entspricht dies der Übergabe von Null.

Siehe auch „ QString::chop()“ und „ truncate()“.

QStringRef QStringRef::chopped(int len) const

Gibt eine Teilzeichenfolgenreferenz auf die size() - len Zeichen ganz links in dieser Zeichenkette zurück.

Hinweis: Das Verhalten ist undefiniert, wenn len negativ oder größer als size() ist.

Siehe auch endsWith(), left(), right(), mid(), chop() und truncate().

void QStringRef::clear()

Löscht den Inhalt der Zeichenfolgenreferenz, indem sie auf null gesetzt und geleert wird.

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

[static noexcept] int QStringRef::compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Vergleicht s1 mit s2 und gibt eine negative Ganzzahl zurück, wenn s1 kleiner als s2 ist, eine positive Ganzzahl, wenn es größer als s2 ist, und Null, wenn beide gleich sind.

Ist cs gleich Qt::CaseSensitive, wird bei dem Vergleich die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

[noexcept] int QStringRef::compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Vergleicht *this mit ch und gibt eine negative Ganzzahl zurück, wenn *this kleiner als ch ist, eine positive Ganzzahl, wenn es größer als ch ist, und Null, wenn beide gleich sind. Dabei wird ch als Zeichenkette der Länge eins interpretiert.

Ist cs gleich Qt::CaseSensitive, wird beim Vergleich die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

Dies ist eine überladene Funktion.

[noexcept] int QStringRef::compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Vergleicht *this mit other und gibt eine negative Ganzzahl zurück, wenn *this kleiner als other ist, eine positive Ganzzahl, wenn es größer als other ist, und Null, wenn beide gleich sind.

Ist cs gleich Qt::CaseSensitive, wird beim Vergleich die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

Entspricht compare(*this, other, cs).

Dies ist eine überladene Funktion.

[noexcept] int QStringRef::compare(const QByteArray &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Vergleicht *this mit other und gibt eine negative Ganzzahl zurück, wenn *this kleiner als other ist, eine positive Ganzzahl, wenn es größer als other ist, und Null, wenn beide gleich sind. Der Inhalt von other wird als UTF-8 interpretiert.

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

Entspricht compare(*this, other, cs).

Dies ist eine überladene Funktion.

[noexcept] int QStringRef::compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Vergleicht *this mit other und gibt eine negative Ganzzahl zurück, wenn *this kleiner als other ist, eine positive Ganzzahl, wenn es größer als other ist, und Null, wenn beide gleich sind.

Ist cs gleich Qt::CaseSensitive, wird beim Vergleich die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Entspricht compare(*this, other, cs).

Dies ist eine überladene Funktion.

[noexcept] int QStringRef::compare(const QStringRef &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Vergleicht *this mit other und gibt eine negative Ganzzahl zurück, wenn *this kleiner als other ist, eine positive Ganzzahl, wenn es größer als other ist, und Null, wenn beide gleich sind.

Ist cs gleich Qt::CaseSensitive, wird beim Vergleich die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Entspricht compare(*this, other, cs).

Dies ist eine überladene Funktion.

[static noexcept] int QStringRef::compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Vergleicht s1 mit s2 und gibt eine negative Ganzzahl zurück, wenn s1 kleiner als s2 ist, eine positive Ganzzahl, wenn es größer als s2 ist, und Null, wenn beide gleich sind.

Ist cs gleich Qt::CaseSensitive, wird beim Vergleich die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Dies ist eine überladene Funktion.

[static noexcept] int QStringRef::compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Vergleicht s1 mit s2 und gibt eine negative Ganzzahl zurück, wenn s1 kleiner als s2 ist, eine positive Ganzzahl, wenn es größer als s2 ist, und Null, wenn beide gleich sind.

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

Dies ist eine überladene Funktion.

QStringRef::const_iterator QStringRef::constBegin() const

Wie unter begin() beschrieben.

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

const QChar *QStringRef::constData() const

Entspricht „ unicode()“.

QStringRef::const_iterator QStringRef::constEnd() const

Wie unter end() beschrieben.

Siehe auch end(), cend(), cbegin(), constBegin(), rbegin() und rend().

bool QStringRef::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn diese Zeichenfolgenreferenz das Zeichenfolgenelement „ str “ enthält; andernfalls wird „ false “ zurückgegeben.

Wenn „ cs “ auf „ Qt::CaseSensitive “ gesetzt ist (Standard), wird bei der Suche die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

Siehe auch indexOf() und count().

bool QStringRef::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn diese Zeichenfolge das Zeichen „ ch “ enthält; andernfalls wird „ false “ zurückgegeben.

Ist „ cs “ auf „ Qt::CaseSensitive “ gesetzt (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Diese Funktion überlädt die Funktion ` QStringRef::contains()`.

bool QStringRef::contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn diese Zeichenfolgenreferenz das Zeichenfolgenelement „ str “ enthält; andernfalls wird „ false “ zurückgegeben.

Ist „ cs “ gleich „ Qt::CaseSensitive “ (Standard), wird bei der Suche die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

Diese Funktion überlädt QStringRef::contains().

Siehe auch indexOf() und count().

[noexcept] bool QStringRef::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn diese Zeichenfolgenreferenz das Zeichenfolgenelement „ str “ enthält; andernfalls wird „ false “ zurückgegeben.

Wenn „ cs “ auf „ Qt::CaseSensitive “ gesetzt ist (Standard), wird bei der Suche die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

Diese Funktion überlädt die Funktion ` QStringRef::contains()`.

Siehe auch indexOf() und count().

bool QStringRef::contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn diese Zeichenfolgenreferenz ein Vorkommen der Zeichenfolgenreferenz „ str “ enthält; andernfalls wird „ false “ zurückgegeben.

Ist ` cs ` gleich ` Qt::CaseSensitive ` (Standard), wird bei der Suche die Groß-/Kleinschreibung beachtet; andernfalls erfolgt die Suche unabhängig von der Groß-/Kleinschreibung.

Diese Funktion überlädt QStringRef::contains().

Siehe auch indexOf() und count().

int QStringRef::count() const

Gibt die Anzahl der Zeichen zurück, auf die sich die Zeichenfolgenreferenz bezieht. Entspricht den Funktionen „ size()“ und „ length()“.

Siehe auch position() und string().

int QStringRef::count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Anzahl der (möglicherweise überlappenden) Vorkommen der Zeichenfolge „ str “ in dieser Zeichenfolgenreferenz zurück.

Wenn „ cs “ auf „ Qt::CaseSensitive “ gesetzt ist (Standard), wird bei der Suche die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

Siehe auch „ QString::count()“, „ contains()“ und „ indexOf()“.

int QStringRef::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Anzahl der Vorkommen des Zeichens „ ch “ in der Zeichenfolgenreferenz zurück.

Ist „ cs “ auf „ Qt::CaseSensitive “ gesetzt (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Diese Funktion überlädt die Funktion ` QStringRef::count()`.

Siehe auch QString::count(), contains() und indexOf().

int QStringRef::count(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Anzahl der (möglicherweise überlappenden) Vorkommen der Zeichenfolgenreferenz str in dieser Zeichenfolgenreferenz zurück.

Ist cs auf „ Qt::CaseSensitive “ gesetzt (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Diese Funktion überlädt „ QStringRef::count()“.

Siehe auch QString::count(), contains() und indexOf().

QStringRef::const_reverse_iterator QStringRef::crbegin() const

Wie unter rbegin() beschrieben.

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

QStringRef::const_reverse_iterator QStringRef::crend() const

Wie unter rend() beschrieben.

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

const QChar *QStringRef::data() const

Entspricht unicode().

QStringRef::const_iterator QStringRef::end() const

Gibt einen konstanten Iterator im STL-Stil zurück, der auf das imaginäre Zeichen nach dem letzten Zeichen in der Liste zeigt.

Siehe auch cbegin(), constBegin(), end(), constEnd(), rbegin() und rend().

bool QStringRef::endsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz mit „ str “ endet; andernfalls wird „ false “ zurückgegeben.

Wenn cs den Wert Qt::CaseSensitive hat (Standard), wird bei der Suche die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

Siehe auch QString::endsWith() und startsWith().

bool QStringRef::endsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz mit „ ch “ endet; andernfalls wird „ false “ zurückgegeben.

Ist cs gleich Qt::CaseSensitive (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Diese Funktion überlädt QStringRef::endsWith().

Siehe auch QString::endsWith() und endsWith().

bool QStringRef::endsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Diese Funktion überlädt die Funktion „ QStringRef::endsWith()“.

Siehe auch „ QString::endsWith()“ und „ endsWith()“.

[noexcept] bool QStringRef::endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Diese Funktion überlädt die Funktion „ QStringRef::endsWith()“.

Siehe auch „ QString::endsWith()“ und „ startsWith()“.

bool QStringRef::endsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Diese Funktion überlädt die Funktion „ QStringRef::endsWith()“.

Siehe auch „ QString::endsWith()“ und „ endsWith()“.

QChar QStringRef::front() const

Gibt das erste Zeichen der Zeichenkette zurück. Entspricht „ at(0) “.

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

Warnung: Der Aufruf dieser Funktion für eine leere Zeichenkette führt zu undefiniertem Verhalten.

Siehe auch „ back()“, „ at()“ und „ operator[]()“.

int QStringRef::indexOf(QLatin1String str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des ersten Vorkommens der Zeichenfolge „ str “ in dieser Zeichenfolgenreferenz zurück, wobei die Suche ab der Indexposition „ from “ vorwärts erfolgt. Gibt -1 zurück, wenn „ str “ nicht gefunden wird.

Ist „ cs “ gleich „ Qt::CaseSensitive “ (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Ist from gleich -1, beginnt die Suche am letzten Zeichen; ist es gleich -2, am vorletzten Zeichen und so weiter.

Siehe auch QString::indexOf(), lastIndexOf(), contains() und count().

int QStringRef::indexOf(const QString &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des ersten Vorkommens der Zeichenkette „ str “ in dieser Zeichenkettenreferenz zurück, wobei die Suche ab der Indexposition „ from “ vorwärts erfolgt. Gibt -1 zurück, wenn „ str “ nicht gefunden wird.

Ist cs gleich Qt::CaseSensitive (Standard), wird bei der Suche die Groß-/Kleinschreibung beachtet; andernfalls wird die Groß-/Kleinschreibung nicht beachtet.

Ist from gleich -1, beginnt die Suche beim letzten Zeichen; bei -2 beim vorletzten Zeichen und so weiter.

Siehe auch QString::indexOf(), lastIndexOf(), contains() und count().

int QStringRef::indexOf(QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des ersten Vorkommens des Zeichens „ ch “ in der Zeichenfolgenreferenz zurück, wobei die Suche ab der Indexposition „ from “ vorwärts erfolgt. Gibt -1 zurück, wenn „ ch “ nicht gefunden werden konnte.

Diese Funktion überlädt die Funktion ` QStringRef::indexOf()`.

Siehe auch QString::indexOf(), lastIndexOf(), contains() und count().

[noexcept] int QStringRef::indexOf(QStringView str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des ersten Vorkommens der Zeichenfolgenansicht str in dieser Zeichenfolgenreferenz zurück, wobei die Suche ab der Indexposition from vorwärts erfolgt. Gibt -1 zurück, wenn str nicht gefunden wird.

Ist cs gleich Qt::CaseSensitive (Standard), wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird die Groß- und Kleinschreibung nicht berücksichtigt.

Ist from gleich -1, beginnt die Suche am letzten Zeichen; ist es gleich -2, am vorletzten Zeichen und so weiter.

Diese Funktion überlädt die Funktion ` QStringRef::indexOf()`.

Siehe auch QString::indexOf(), QStringView::indexOf(), lastIndexOf(), contains() und count().

int QStringRef::indexOf(const QStringRef &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des ersten Vorkommens der Zeichenfolgenreferenz str in dieser Zeichenfolgenreferenz zurück, wobei die Suche ab der Indexposition from vorwärts erfolgt. Gibt -1 zurück, wenn str nicht gefunden wird.

Ist cs gleich Qt::CaseSensitive (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls erfolgt die Suche ohne Berücksichtigung der Groß-/Kleinschreibung.

Diese Funktion überlädt QStringRef::indexOf().

Siehe auch QString::indexOf(), lastIndexOf(), contains() und count().

bool QStringRef::isEmpty() const

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz keine Zeichen enthält; andernfalls wird „ false “ zurückgegeben.

Eine Zeichenfolgenreferenz ist leer, wenn ihre Größe Null ist.

Siehe auch ` size()`.

bool QStringRef::isNull() const

Gibt „ true “ zurück, wenn diese String-Referenz nicht auf einen String verweist oder wenn der String, auf den sie verweist, null ist (d. h., wenn „ QString::isNull()“ wahr ist).

Siehe auch ` size()`.

bool QStringRef::isRightToLeft() const

Gibt „ true “ zurück, wenn die Zeichenkette von rechts nach links gelesen wird.

Siehe auch QString::isRightToLeft().

int QStringRef::lastIndexOf(const QString &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des letzten Vorkommens der Zeichenkette „ str “ in dieser Zeichenkettenreferenz zurück, wobei die Suche rückwärts ab der Indexposition „ from “ erfolgt. Ist „ from “ gleich -1 (Standard), beginnt die Suche am letzten Zeichen; ist „ from “ gleich -2, am vorletzten Zeichen und so weiter. Gibt -1 zurück, wenn „ str “ nicht gefunden wird.

Ist cs gleich Qt::CaseSensitive (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Siehe auch QString::lastIndexOf(), indexOf(), contains() und count().

int QStringRef::lastIndexOf(QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des letzten Vorkommens des Zeichens „ ch “ zurück, wobei rückwärts von der Position „ from “ gesucht wird.

Diese Funktion überlädt die Funktion ` QStringRef::lastIndexOf()`.

Siehe auch QString::lastIndexOf(), indexOf(), contains() und count().

int QStringRef::lastIndexOf(QLatin1String str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des letzten Vorkommens der Zeichenkette „ str “ in dieser Zeichenkettenreferenz zurück, wobei die Suche rückwärts ab der Indexposition „ from “ erfolgt. Ist „ from “ gleich -1 (Standard), beginnt die Suche am letzten Zeichen; ist „ from “ gleich -2, am vorletzten Zeichen und so weiter. Gibt -1 zurück, wenn „ str “ nicht gefunden wird.

Ist „ cs “ auf „ Qt::CaseSensitive “ gesetzt (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Diese Funktion überlädt „ QStringRef::lastIndexOf()“.

Siehe auch QString::lastIndexOf(), indexOf(), contains() und count().

[noexcept] int QStringRef::lastIndexOf(QStringView str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des letzten Vorkommens der Zeichenkette „view str “ in dieser Zeichenkette zurück, wobei die Suche rückwärts ab der Indexposition „ from “ erfolgt. Ist „ from “ gleich -1 (Standard), beginnt die Suche am letzten Zeichen; ist „ from “ gleich -2, am vorletzten Zeichen und so weiter. Gibt -1 zurück, wenn „ str “ nicht gefunden wird.

Ist cs gleich „ Qt::CaseSensitive “ (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Diese Funktion überlädt „ QStringRef::lastIndexOf()“.

Siehe auch indexOf(), contains() und count().

int QStringRef::lastIndexOf(const QStringRef &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt die Indexposition des letzten Vorkommens der Zeichenfolgenreferenz „ str “ in dieser Zeichenfolgenreferenz zurück, wobei die Suche rückwärts ab der Indexposition „ from “ erfolgt. Ist „ from “ gleich -1 (Standard), beginnt die Suche am letzten Zeichen; ist „ from “ gleich -2, am vorletzten Zeichen und so weiter. Gibt -1 zurück, wenn „ str “ nicht gefunden wird.

Ist cs auf „ Qt::CaseSensitive “ gesetzt (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Diese Funktion überlagert QStringRef::lastIndexOf().

Siehe auch QString::lastIndexOf(), indexOf(), contains() und count().

QStringRef QStringRef::left(int n) const

Gibt eine Teilzeichenfolgenreferenz auf die n Zeichen ganz links in der Zeichenkette zurück.

Ist ` n ` größer oder gleich ` size()` oder kleiner als Null, wird eine Referenz auf die gesamte Zeichenkette zurückgegeben.

Siehe auch right(), mid(), startsWith(), chopped(), chop() und truncate().

int QStringRef::length() const

Gibt die Anzahl der Zeichen zurück, auf die sich die Zeichenfolgenreferenz bezieht. Entspricht den Funktionen „ size()“ und „ count()“.

Siehe auch position() und string().

[static] int QStringRef::localeAwareCompare(const QStringRef &s1, const QString &s2)

Vergleicht s1 mit s2 und gibt eine negative Ganzzahl zurück, wenn s1 kleiner als s2 ist, eine positive Ganzzahl, wenn es größer als s2 ist, und Null, wenn beide gleich sind.

Der Vergleich erfolgt lokal- und plattformabhängig. Verwenden Sie diese Funktion, um dem Benutzer sortierte Listen von Zeichenfolgen anzuzeigen.

Siehe auch compare(), QLocale und Comparing Strings.

int QStringRef::localeAwareCompare(const QString &other) const

Vergleicht *this mit other und gibt eine negative Ganzzahl zurück, wenn *this kleiner als other ist, eine positive Ganzzahl, wenn es größer als other ist, und Null, wenn beide gleich sind.

Der Vergleich erfolgt lokalisierungs- und plattformabhängig. Verwenden Sie diese Funktion, um dem Benutzer sortierte Listen von Zeichenfolgen anzuzeigen.

Dies ist eine überladene Funktion.

Siehe auch Comparing Strings.

int QStringRef::localeAwareCompare(const QStringRef &other) const

Vergleicht *this mit other und gibt eine negative Ganzzahl zurück, wenn *this kleiner als other ist, eine positive Ganzzahl, wenn es größer als other ist, und Null, wenn beide gleich sind.

Der Vergleich erfolgt lokal- und plattformabhängig. Verwenden Sie diese Funktion, um dem Benutzer sortierte Listen von Zeichenfolgen anzuzeigen.

Dies ist eine überladene Funktion.

Siehe auch ` Comparing Strings`.

[static] int QStringRef::localeAwareCompare(const QStringRef &s1, const QStringRef &s2)

Vergleicht s1 mit s2 und gibt eine negative ganze Zahl zurück, wenn s1 kleiner als s2 ist, eine positive ganze Zahl, wenn es größer als s2 ist, und Null, wenn beide gleich sind.

Der Vergleich erfolgt lokal- und plattformabhängig. Verwenden Sie diese Funktion, um dem Benutzer sortierte Listen von Zeichenfolgen anzuzeigen.

Dies ist eine überladene Funktion.

Siehe auch Comparing Strings.

QStringRef QStringRef::mid(int position, int n = -1) const

Gibt eine Teilzeichenfolgenreferenz auf die Zeichen „ n “ dieser Zeichenfolge zurück, beginnend an der angegebenen Position „ position “.

Wenn die ` position ` die Länge der Zeichenkette überschreitet, wird eine Null-Referenz zurückgegeben.

Wenn das resultierende „ position “ () nicht in „ int “ dargestellt werden kann, wird eine Null- QStringRef zurückgegeben.

Wenn in der Zeichenkette, beginnend bei dem angegebenen position, weniger als n Zeichen verfügbar sind oder wenn n gleich -1 ist (Standard), gibt die Funktion alle Zeichen ab der angegebenen position zurück.

Siehe auch left(), right(), chopped(), chop() und truncate().

int QStringRef::position() const

Gibt die Startposition in der Zeichenkette zurück, auf die die Zeichenkettenreferenz verweist.

Siehe auch „ size()“ und „ string()“.

QStringRef::const_reverse_iterator QStringRef::rbegin() const

Gibt einen konstanten Reverse-Iterator im STL-Stil zurück, der in umgekehrter Reihenfolge auf das erste Zeichen der Zeichenkette zeigt.

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

QStringRef::const_reverse_iterator QStringRef::rend() const

Gibt einen Reverse-Iterator im STL-Stil zurück, der in umgekehrter Reihenfolge auf die Position unmittelbar nach dem letzten Zeichen der Zeichenkette verweist.

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

Gibt eine Teilzeichenfolgenreferenz auf die n Zeichen ganz rechts in der Zeichenkette zurück.

Ist ` n ` größer oder gleich ` size()` oder kleiner als Null, wird eine Referenz auf die gesamte Zeichenkette zurückgegeben.

Wenn der neue Wert von ` position()` nicht in ` int` dargestellt werden kann, wird eine Referenz auf die gesamte Zeichenkette zurückgegeben.

Siehe auch left(), mid(), endsWith(), chopped(), chop() und truncate().

int QStringRef::size() const

Gibt die Anzahl der Zeichen zurück, auf die sich die Zeichenfolgenreferenz bezieht. Entspricht den Funktionen „ length()“ und „ count()“.

Siehe auch position() und string().

QList<QStringRef> QStringRef::split(const QString &sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Teilt die Zeichenkette an allen Stellen, an denen sep vorkommt, in Teilzeichenketten auf und gibt die Liste dieser Zeichenketten zurück.

Unter „ QString::split()“ erfahren Sie, wie „ sep “, „ behavior “ und „ cs “ zusammenwirken, um das Ergebnis zu bilden.

Hinweis: Alle Verweise sind gültig, solange diese Zeichenkette existiert. Wird diese Zeichenkette gelöscht, werden alle Verweise zu hängenden Zeigern.

QList<QStringRef> QStringRef::split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Dies ist eine überladene Funktion.

bool QStringRef::startsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz mit „ str “ beginnt; andernfalls wird „ false “ zurückgegeben.

Ist cs gleich Qt::CaseSensitive (Standard), wird bei der Suche die Groß-/Kleinschreibung berücksichtigt; andernfalls wird die Groß-/Kleinschreibung nicht berücksichtigt.

Siehe auch QString::startsWith() und endsWith().

bool QStringRef::startsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz mit „ ch “ beginnt; andernfalls wird „ false “ zurückgegeben.

Ist cs gleich Qt::CaseSensitive (Standard), wird bei der Suche zwischen Groß- und Kleinschreibung unterschieden; andernfalls wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Diese Funktion überlädt die Funktion „ QStringRef::startsWith()“.

Siehe auch QString::startsWith() und endsWith().

bool QStringRef::startsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Diese Funktion überlädt „ QStringRef::startsWith()“.

Siehe auch „ QString::startsWith()“ und „ endsWith()“.

[noexcept] bool QStringRef::startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Diese Funktion überlädt die Funktion „ QStringRef::startsWith()“.

Siehe auch „ QString::startsWith()“ und „ endsWith()“.

bool QStringRef::startsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Diese Funktion überlädt die Funktion „ QStringRef::startsWith()“.

Siehe auch „ QString::startsWith()“ und „ endsWith()“.

const QString *QStringRef::string() const

Gibt einen Zeiger auf die Zeichenkette zurück, auf die die Zeichenkettenreferenz verweist, oder 0, wenn sie nicht auf eine Zeichenkette verweist.

Siehe auch „ unicode()“.

double QStringRef::toDouble(bool *ok = nullptr) const

Gibt die Zeichenkette zurück, die in einen Wert vom Typ „ double “ konvertiert wurde.

Gibt „unendlich“ zurück, wenn bei der Konvertierung ein Überlauf auftritt, oder 0,0, wenn die Konvertierung aus anderen Gründen fehlschlägt (z. B. Unterlauf).

Ist ` ok ` nicht ` nullptr`, wird ein Fehler gemeldet, indem *`ok ` auf ` false` gesetzt wird, und ein Erfolg, indem *`ok ` auf ` true` gesetzt wird.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toDouble().

Aus historischen Gründen unterstützt diese Funktion keine Trennzeichen für Tausendergruppen. Wenn Sie solche Zahlen konvertieren müssen, verwenden Sie QLocale::toDouble().

Siehe auch QString::toDouble().

float QStringRef::toFloat(bool *ok = nullptr) const

Gibt die in einen Wert vom Typ „ float “ konvertierte Zeichenkette zurück.

Gibt „unendlich“ zurück, wenn bei der Konvertierung ein Überlauf auftritt, oder 0,0, wenn die Konvertierung aus anderen Gründen fehlschlägt (z. B. Unterlauf).

Ist ` ok ` nicht auf ` nullptr` gesetzt, wird ein Fehler durch Setzen von *`ok ` auf ` false` gemeldet, ein Erfolg durch Setzen von *`ok ` auf ` true`.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwende QLocale::toFloat()

Siehe auch QString::toFloat().

int QStringRef::toInt(bool *ok = nullptr, int base = 10) const

Gibt die Zeichenkette zurück, die unter Verwendung der Basis base in ein int konvertiert wurde. Der Standardwert für die Basis ist 10; er muss zwischen 2 und 36 liegen oder 0 sein. Bei Fehlschlagen der Konvertierung wird 0 zurückgegeben.

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Ist base gleich 0, wird die Konvention der Programmiersprache C verwendet: Beginnt die Zeichenkette mit „0x“, wird die Basis 16 verwendet; beginnt die Zeichenkette mit „0“, wird die Basis 8 verwendet; andernfalls wird die Basis 10 verwendet.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toInt().

Siehe auch QString::toInt().

QByteArray QStringRef::toLatin1() const

Gibt eine Latin-1-Darstellung der Zeichenkette als ` QByteArray` zurück.

Das zurückgegebene Byte-Array ist undefiniert, wenn die Zeichenkette Nicht-Latin-1-Zeichen enthält. Diese Zeichen können unterdrückt oder durch ein Fragezeichen ersetzt werden.

Siehe auch ` toUtf8()`, ` toLocal8Bit()` und ` QStringEncoder`.

QByteArray QStringRef::toLocal8Bit() const

Gibt die lokale 8-Bit-Darstellung der Zeichenkette als ` QByteArray` zurück. Das zurückgegebene Byte-Array ist undefiniert, wenn die Zeichenkette Zeichen enthält, die von der lokalen 8-Bit-Kodierung nicht unterstützt werden.

Auf Unix-Systemen entspricht dies ` toUtf8()`, unter Windows wird die aktuelle Codepage des Systems verwendet.

Enthält diese Zeichenkette Zeichen, die in der Locale nicht kodiert werden können, ist das zurückgegebene Byte-Array undefiniert. Diese Zeichen können unterdrückt oder durch andere ersetzt werden.

Siehe auch toLatin1(), toUtf8() und QStringEncoder.

long QStringRef::toLong(bool *ok = nullptr, int base = 10) const

Gibt die Zeichenkette zurück, die unter Verwendung der Basis base in ein long konvertiert wurde. Der Standardwert für ist 10; er muss zwischen 2 und 36 liegen oder 0 sein. Bei fehlgeschlagener Konvertierung wird 0 zurückgegeben.

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Ist base gleich 0, wird die Konvention der Programmiersprache C verwendet: Beginnt die Zeichenkette mit „0x“, wird die Basis 16 verwendet; beginnt die Zeichenkette mit „0“, wird die Basis 8 verwendet; andernfalls wird die Basis 10 verwendet.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toLong().

Siehe auch ` QString::toLong()`.

qlonglong QStringRef::toLongLong(bool *ok = nullptr, int base = 10) const

Gibt die Zeichenkette zurück, die unter Verwendung der Basis base in ein long long konvertiert wurde. Der Standardwert für ist 10; er muss zwischen 2 und 36 liegen oder 0 sein. Bei fehlgeschlagener Konvertierung wird 0 zurückgegeben.

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Ist base gleich 0, wird die Konvention der Programmiersprache C verwendet: Beginnt die Zeichenkette mit „0x“, wird die Basis 16 verwendet; beginnt die Zeichenkette mit „0“, wird die Basis 8 verwendet; andernfalls wird die Basis 10 verwendet.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toLongLong().

Siehe auch QString::toLongLong().

short QStringRef::toShort(bool *ok = nullptr, int base = 10) const

Gibt die Zeichenkette zurück, die unter Verwendung der Basis base in ein short konvertiert wurde. Der Standardwert für die Basis ist 10; er muss zwischen 2 und 36 liegen oder 0 sein. Gibt 0 zurück, wenn die Konvertierung fehlschlägt.

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Ist base gleich 0, wird die Konvention der Programmiersprache C verwendet: Beginnt die Zeichenkette mit „0x“, wird die Basis 16 verwendet; beginnt die Zeichenkette mit „0“, wird die Basis 8 verwendet; andernfalls wird die Basis 10 verwendet.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toShort().

Siehe auch ` QString::toShort()`.

QString QStringRef::toString() const

Gibt eine Kopie der String-Referenz als „ QString “-Objekt zurück.

Wenn die Zeichenfolgenreferenz keine vollständige Referenz auf die Zeichenfolge ist (d. h. wenn ` position()` den Wert 0 hat und ` size()` gleich ` string()` ist, was wiederum `size()` ergibt), weist diese Funktion eine neue Zeichenfolge zu, die zurückgegeben wird.

Siehe auch string().

uint QStringRef::toUInt(bool *ok = nullptr, int base = 10) const

Gibt die Zeichenkette zurück, die unter Verwendung der Basis base in ein unsigned int konvertiert wurde. Die Basis ist standardmäßig 10 und muss zwischen 2 und 36 oder 0 liegen. Gibt 0 zurück, wenn die Konvertierung fehlschlägt.

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Ist base gleich 0, wird die Konvention der Programmiersprache C verwendet: Beginnt die Zeichenkette mit „0x“, wird die Basis 16 verwendet; beginnt die Zeichenkette mit „0“, wird die Basis 8 verwendet; andernfalls wird die Basis 10 verwendet.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toUInt().

Siehe auch ` QString::toUInt()`.

ulong QStringRef::toULong(bool *ok = nullptr, int base = 10) const

Gibt die Zeichenkette zurück, die unter Verwendung der Basis base in ein unsigned long konvertiert wurde. Der Standardwert für ist 10; er muss zwischen 2 und 36 liegen oder 0 sein. Bei fehlgeschlagener Konvertierung wird 0 zurückgegeben.

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Ist base gleich 0, wird die Konvention der Programmiersprache C verwendet: Beginnt die Zeichenkette mit „0x“, wird die Basis 16 verwendet; beginnt die Zeichenkette mit „0“, wird die Basis 8 verwendet; andernfalls wird die Basis 10 verwendet.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toULongLong().

Siehe auch ` QString::toULong()`.

qulonglong QStringRef::toULongLong(bool *ok = nullptr, int base = 10) const

Gibt die in eine „ unsigned long long “ konvertierte Zeichenkette zurück, wobei die Basis „ base “ verwendet wird. Der Standardwert ist 10; der Wert muss zwischen 2 und 36 liegen oder 0 sein. Bei fehlgeschlagener Konvertierung wird 0 zurückgegeben.

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Ist „ base “ gleich 0, wird die Konvention der Programmiersprache C verwendet: Beginnt die Zeichenkette mit „0x“, wird die Basis 16 verwendet; beginnt die Zeichenkette mit „0“, wird die Basis 8 verwendet; andernfalls wird die Basis 10 verwendet.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toULongLong().

Siehe auch ` QString::toULongLong()`.

ushort QStringRef::toUShort(bool *ok = nullptr, int base = 10) const

Gibt die Zeichenkette zurück, die unter Verwendung der Basis base in eine unsigned short konvertiert wurde. Der Standardwert für ist 10; er muss zwischen 2 und 36 liegen oder 0 sein. Bei fehlgeschlagener Konvertierung wird 0 zurückgegeben.

Ist „ ok “ nicht „ nullptr “, wird ein Fehler gemeldet, indem *ok auf „ false “ gesetzt wird, und ein Erfolg, indem *ok auf „ true “ gesetzt wird.

Ist base gleich 0, wird die Konvention der Programmiersprache C verwendet: Beginnt die Zeichenkette mit „0x“, wird die Basis 16 verwendet; beginnt die Zeichenkette mit „0“, wird die Basis 8 verwendet; andernfalls wird die Basis 10 verwendet.

Die Zeichenfolgenkonvertierung erfolgt immer in der Locale „C“. Für eine localeabhängige Konvertierung verwenden Sie QLocale::toUShort().

Siehe auch QString::toUShort().

QList<uint> QStringRef::toUcs4() const

Gibt eine UCS-4/UTF-32-Darstellung der Zeichenkette als „ QList “ <uint> zurück.

UCS-4 ist ein Unicode-Codec und daher verlustfrei. Alle Zeichen dieser Zeichenkette werden in UCS-4 kodiert. Jede ungültige Folge von Codeeinheiten in dieser Zeichenkette wird durch das Unicode-Ersatzzeichen (QChar::ReplacementCharacter, das U+FFFD entspricht) ersetzt.

Die zurückgegebene Liste wird nicht mit \0 abgeschlossen.

Siehe auch toUtf8(), toLatin1(), toLocal8Bit() und QStringEncoder.

QByteArray QStringRef::toUtf8() const

Gibt eine UTF-8-Darstellung der Zeichenkette als „ QByteArray “ zurück.

UTF-8 ist ein Unicode-Codec und kann alle Zeichen in einer Unicode-Zeichenkette wie QString darstellen.

Siehe auch toLatin1(), toLocal8Bit() und QStringEncoder.

QStringRef QStringRef::trimmed() const

Gibt eine Zeichenkette zurück, aus der Leerzeichen am Anfang und am Ende entfernt wurden.

Als Leerzeichen gelten alle Zeichen, für die die Funktion ` QChar::isSpace()` den Wert ` true` zurückgibt. Dazu gehören die ASCII-Zeichen „\t “, „\n “, „\v “, „\f “, „\r “ und „ “.

Im Gegensatz zu „ QString::simplified()“ lässt „trimmed()“ interne Leerzeichen unverändert.

Wenn das neue ` position()` nach dem Entfernen der Leerzeichen nicht in ` int` dargestellt werden kann, ist das Verhalten undefiniert.

Siehe auch ` QString::trimmed()`.

[noexcept] void QStringRef::truncate(int position)

Kürzt die Zeichenkette an der angegebenen Stelle „ position “ ab.

Liegt der angegebene Index „ position “ jenseits des Endes der Zeichenkette, geschieht nichts.

Ist ` position ` negativ, entspricht dies der Übergabe von Null.

Siehe auch ` QString::truncate()`.

const QChar *QStringRef::unicode() const

Gibt eine Unicode-Darstellung der Zeichenfolgenreferenz zurück. Da die Daten direkt aus der referenzierten Zeichenfolge stammen, sind sie nicht mit einem ' \0' abgeschlossen, es sei denn, die Zeichenfolgenreferenz enthält den Null-Terminator der Zeichenfolge.

Siehe auch string().

[noexcept] bool QStringRef::operator!=(const char *s) const

Der Zeiger „ s const char“ wird mithilfe der Funktion „fromUtf8()“ in einen „ QStringRef “ konvertiert.

Sie können diesen Operator deaktivieren, indem Sie beim Kompilieren Ihrer Anwendungen QT_NO_CAST_FROM_ASCII definieren. Dies kann beispielsweise nützlich sein, wenn Sie sicherstellen möchten, dass alle für den Benutzer sichtbaren Zeichenfolgen durch QObject::tr() verarbeitet werden.

Gibt „ true “ zurück, wenn diese Zeichenkette lexikalisch nicht mit der Parameterzeichenkette „ s “ übereinstimmt. Andernfalls wird „ false “ zurückgegeben.

Diese Funktion überlädt QStringRef::operator!=().

Siehe auch „ QT_NO_CAST_FROM_ASCII “.

[noexcept] bool QStringRef::operator<(const char *s) const

Der Zeiger vom Typ „ s const char“ wird mithilfe der Funktion „fromUtf8()“ in einen Zeiger vom Typ „ QStringRef “ konvertiert.

Sie können diesen Operator deaktivieren, indem Sie beim Kompilieren Ihrer Anwendungen ` QT_NO_CAST_FROM_ASCII ` definieren. Dies kann beispielsweise nützlich sein, wenn Sie sicherstellen möchten, dass alle für den Benutzer sichtbaren Zeichenfolgen durch ` QObject::tr()` verarbeitet werden.

Gibt ` true ` zurück, wenn diese Zeichenkette lexikalisch kleiner ist als die Parameterzeichenkette ` s`. Andernfalls wird ` false` zurückgegeben.

Diese Funktion überlädt ` QStringRef::operator<()`.

Siehe auch „ QT_NO_CAST_FROM_ASCII “.

[noexcept] bool QStringRef::operator<=(const char *s) const

Der Zeiger „ s const char“ wird mithilfe der Funktion „fromUtf8()“ in einen „ QStringRef “ konvertiert.

Sie können diesen Operator deaktivieren, indem Sie beim Kompilieren Ihrer Anwendungen ` QT_NO_CAST_FROM_ASCII ` definieren. Dies kann beispielsweise nützlich sein, wenn Sie sicherstellen möchten, dass alle für den Benutzer sichtbaren Zeichenfolgen durch ` QObject::tr()` geleitet werden.

Gibt ` true ` zurück, wenn diese Zeichenkette lexikalisch kleiner oder gleich der Parameterzeichenkette ` s` ist. Andernfalls wird ` false` zurückgegeben.

Diese Funktion überlädt ` QStringRef::operator<=()`.

Siehe auch ` QT_NO_CAST_FROM_ASCII`.

QStringRef &QStringRef::operator=(const QString *string)

Erstellt eine Zeichenfolgenreferenz auf das angegebene ` string ` und weist diese der vorliegenden Zeichenfolgenreferenz zu; anschließend wird das Ergebnis zurückgegeben.

Warnung: „ QStringRef “ verwendet„ int “ (32 Bit), um „ size “ () darzustellen. In Qt 6 wird die Größe von „ QString “ als „ qsizetype “ dargestellt, was bei 64-Bit-Builds 64 Bit entspricht. Stellen Sie sicher, dass die Größe der Eingabe in 32 Bit passt, andernfalls tritt „ the behavior is undefined “ auf.

[implicit] QStringRef &QStringRef::operator=(const QStringRef &other)

Weist dieser Zeichenfolgenreferenz die Referenz auf die Zeichenfolge „ other “ zu und gibt das Ergebnis zurück.

[noexcept] bool QStringRef::operator==(const char *s) const

Das Byte-Array „ s “ wird mithilfe der Funktion „fromUtf8()“ in ein „ QStringRef “ konvertiert. Diese Funktion beendet die Konvertierung beim ersten gefundenen NUL-Zeichen oder am Ende des Byte-Arrays.

Sie können diesen Operator deaktivieren, indem Sie beim Kompilieren Ihrer Anwendungen QT_NO_CAST_FROM_ASCII definieren. Dies kann beispielsweise nützlich sein, wenn Sie sicherstellen möchten, dass alle für den Benutzer sichtbaren Zeichenfolgen durch QObject::tr() verarbeitet werden.

Gibt ` true ` zurück, wenn diese Zeichenkette lexikalisch mit der Parameterzeichenkette ` s` übereinstimmt. Andernfalls wird ` false` zurückgegeben.

Diese Funktion überlädt ` QStringRef::operator==()`.

Siehe auch „ QT_NO_CAST_FROM_ASCII “.

[noexcept] bool QStringRef::operator>(const char *s) const

Der Zeiger vom Typ „ s const char“ wird mithilfe der Funktion „fromUtf8()“ in einen Zeiger vom Typ „ QStringRef “ konvertiert.

Sie können diesen Operator deaktivieren, indem Sie beim Kompilieren Ihrer Anwendungen ` QT_NO_CAST_FROM_ASCII ` definieren. Dies kann beispielsweise nützlich sein, wenn Sie sicherstellen möchten, dass alle für den Benutzer sichtbaren Zeichenfolgen durch ` QObject::tr()` verarbeitet werden.

Gibt ` true ` zurück, wenn diese Zeichenkette lexikalisch größer ist als die Parameterzeichenkette ` s`. Andernfalls wird ` false` zurückgegeben.

Diese Funktion überlädt ` QStringRef::operator>()`.

Siehe auch „ QT_NO_CAST_FROM_ASCII “.

[noexcept] bool QStringRef::operator>=(const char *s) const

Der Zeiger vom Typ „ s const char“ wird mithilfe der Funktion „fromUtf8()“ in einen Zeiger vom Typ „ QStringRef “ konvertiert.

Sie können diesen Operator deaktivieren, indem Sie beim Kompilieren Ihrer Anwendungen ` QT_NO_CAST_FROM_ASCII ` definieren. Dies kann beispielsweise nützlich sein, wenn Sie sicherstellen möchten, dass alle für den Benutzer sichtbaren Zeichenfolgen über ` QObject::tr()` verarbeitet werden.

Gibt ` true ` zurück, wenn diese Zeichenkette lexikalisch größer oder gleich der Parameterzeichenkette ` s` ist. Andernfalls wird ` false` zurückgegeben.

Diese Funktion überlädt die Funktion „ QStringRef::operator>=()“.

Siehe auch „ QT_NO_CAST_FROM_ASCII “.

QChar QStringRef::operator[](int position) const

Gibt das Zeichen an der angegebenen Indexposition „ position “ in der Zeichenfolgenreferenz zurück.

Der Index position muss eine gültige Indexposition in der Zeichenfolgenreferenz sein (d. h. 0 <= position < size()).

Siehe auch ` at()`.

Verwandte Nicht-Mitglieder

[noexcept] bool operator<(const QStringRef &s1, const QStringRef &s2)

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz s1 lexikalisch kleiner ist als die Zeichenfolgenreferenz s2; andernfalls wird „ false “ zurückgegeben.

Siehe auch „ Comparing Strings “.

[noexcept] bool operator<=(const QStringRef &s1, const QStringRef &s2)

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz „ s1 “ lexikalisch kleiner oder gleich der Zeichenfolgenreferenz „ s2 “ ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch „ Comparing Strings “.

[noexcept] bool operator==(QLatin1String s1, const QStringRef &s2)

Gibt „ true “ zurück, wenn die Zeichenkette „ s1 “ lexikalisch mit der Zeichenkettenreferenz „ s2 “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.

[noexcept] bool operator==(const QString &s1, const QStringRef &s2)

Gibt „ true “ zurück, wenn die Zeichenkette „ s1 “ lexikalisch mit der Zeichenkettenreferenz „ s2 “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.

[noexcept] bool operator==(const QStringRef &s1, const QStringRef &s2)

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz s1 lexikalisch mit der Zeichenfolgenreferenz s2 übereinstimmt; andernfalls wird „ false “ zurückgegeben.

[noexcept] bool operator>(const QStringRef &s1, const QStringRef &s2)

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz „ s1 “ lexikalisch größer ist als die Zeichenfolgenreferenz „ s2 “; andernfalls wird „ false “ zurückgegeben.

Siehe auch „ Comparing Strings “.

[noexcept] bool operator>=(const QStringRef &s1, const QStringRef &s2)

Gibt „ true “ zurück, wenn die Zeichenfolgenreferenz „ s1 “ lexikalisch größer oder gleich der Zeichenfolgenreferenz „ s2 “ ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch „ Comparing Strings “.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.