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 |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QStringRef ist Teil der Klassen für Zeichenfolgendaten.
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) |
Zugehörige Nicht-Mitglieder
| 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().
QStringRef QStringRef::right(int n) const
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.