QStringRef Class

Documentation sur les fonctions membres

[constexpr noexcept] QStringRef::QStringRef()

Crée une référence à une chaîne vide.

QStringRef::QStringRef(const QString *string)

Crée une référence de chaîne vers l'string fournie.

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

Crée une référence de chaîne vers la plage de caractères contenue dans le fichier « string » fourni, spécifiée par les valeurs de départ « position » et « length » en nombre de caractères.

Cela signifie que la position de départ position doit être positive ou égale à 0 et inférieure à la longueur de string, et que length doit être positive ou égale à 0 mais inférieure à la longueur de la chaîne moins la position de départ position; c'est-à-dire que les conditions suivantes doivent être toutes deux satisfaites : 0 <= position < string->length() et 0 <= length <= string->length() - position.

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

Crée une copie de la référence de chaîne « other ».

[noexcept implicit] QStringRef::~QStringRef()

Détruit la référence à la chaîne.

Comme cette classe sert uniquement à faire référence à des données de type chaîne et n'en devient pas propriétaire, aucune mémoire n'est libérée lorsque les instances sont détruites.

QStringRef QStringRef::appendTo(QString *string) const

Ajoute la référence à la chaîne à string et renvoie une nouvelle référence aux données de la chaîne combinée.

const QChar QStringRef::at(int position) const

Renvoie le caractère situé à l'position d'index spécifiée dans la référence de chaîne.

L'position doit correspondre à une position d'index valide dans la chaîne (c'est-à-dire 0 <= position < size()).

QChar QStringRef::back() const

Renvoie le dernier caractère de la chaîne. Équivalent à ` at(size() - 1)`.

Cette fonction est fournie à des fins de compatibilité avec la STL.

Voir également front(), at() et operator[]().

QStringRef::const_iterator QStringRef::begin() const

Renvoie un itérateur de type STL constant pointant vers le premier caractère de la chaîne.

Voir également cbegin(), constBegin(), end(), constEnd(), rbegin() et rend().

QStringRef::const_iterator QStringRef::cbegin() const

Identique à begin().

Voir également begin(), constBegin(), cend(), constEnd(), rbegin() et rend().

QStringRef::const_iterator QStringRef::cend() const

Identique à end().

Voir également end(), constEnd(), cbegin(), constBegin(), rbegin() et rend().

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

Supprime les caractères n à la fin de la chaîne.

Si n est supérieur ou égal à size(), le résultat est une chaîne vide ; si n est négatif, cela revient à passer zéro.

Voir également QString::chop() et truncate().

QStringRef QStringRef::chopped(int len) const

Renvoie une référence à la sous-chaîne correspondant aux caractères situés le plus à gauche de cette chaîne, selon la fonction size() - len.

Voir également endsWith(), left(), right(), mid(), chop() et truncate().

void QStringRef::clear()

Efface le contenu de la référence de chaîne en la rendant nulle et vide.

Voir également isEmpty() et isNull().

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

Compare s1 à s2 et renvoie un entier négatif si s1 est inférieur à s2, un entier positif s'il est supérieur à s2, et zéro s'ils sont égaux.

Si cs est égal à Qt::CaseSensitive, la comparaison tient compte de la casse ; dans le cas contraire, elle ne tient pas compte de la casse.

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

Compare *this avec ch et renvoie un entier négatif si *this est inférieur à ch, un entier positif s'il est supérieur à ch, et zéro s'ils sont égaux. Ici, ch est interprété comme une chaîne de caractères de longueur un.

Si cs est Qt::CaseSensitive, la comparaison tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

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

Compare *this à other et renvoie un entier négatif si *this est inférieur à other, un entier positif s'il est supérieur à other, et zéro s'ils sont égaux.

Si cs est égal à Qt::CaseSensitive, la comparaison tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Équivalent à ` compare(*this, other, cs)`.

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

Compare *this avec other et renvoie un entier négatif si *this est inférieur à other, un entier positif s'il est supérieur à other, et zéro s'ils sont égaux. Le contenu de other est interprété au format UTF-8.

Si cs vaut Qt::CaseSensitive, la comparaison tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Équivalent à compare(*this, other, cs).

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

Compare *this à other et renvoie un entier négatif si *this est inférieur à other, un entier positif s'il est supérieur à other, et zéro s'ils sont égaux.

Si cs est égal à Qt::CaseSensitive, la comparaison tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Équivalent à compare(*this, other, cs).

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

Compare *this à other et renvoie un entier négatif si *this est inférieur à other, un entier positif s'il est supérieur à other, et zéro s'ils sont égaux.

Si cs est égal à Qt::CaseSensitive, la comparaison tient compte de la casse ; dans le cas contraire, elle ne tient pas compte de la casse.

Équivalent à compare(*this, other, cs).

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

Compare s1 à s2 et renvoie un entier négatif si s1 est inférieur à s2, un entier positif s'il est supérieur à s2, et zéro s'ils sont égaux.

Si cs est égal à Qt::CaseSensitive, la comparaison tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

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

Compare s1 à s2 et renvoie un entier négatif si s1 est inférieur à s2, un entier positif s'il est supérieur à s2, et zéro s'ils sont égaux.

Si cs est égal à Qt::CaseSensitive, la comparaison tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

QStringRef::const_iterator QStringRef::constBegin() const

Identique à begin().

Voir également begin(), cend(), constEnd(), rbegin() et rend().

const QChar *QStringRef::constData() const

Identique à ` unicode()`.

QStringRef::const_iterator QStringRef::constEnd() const

Identique à end().

Voir également end(), cend(), cbegin(), constBegin(), rbegin() et rend().

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

Renvoie ` true ` si cette référence de chaîne contient une occurrence de la chaîne ` str` ; sinon, renvoie ` false`.

Si cs est Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également indexOf() et count().

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

Renvoie « true » si cette chaîne contient au moins une occurrence du caractère « ch » ; sinon, renvoie « false ».

Si cs vaut Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

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

Renvoie « true » si cette référence de chaîne contient une occurrence de la chaîne « str » ; sinon, renvoie « false ».

Si cs est égal à Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également indexOf() et count().

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

Renvoie « true » si cette référence de chaîne contient une occurrence de la chaîne « view str » ; sinon, renvoie « false ».

Si cs est égal à Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également indexOf() et count().

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

Renvoie ` true ` si cette référence de chaîne contient une occurrence de la référence de chaîne ` str` ; sinon, renvoie ` false`.

Si cs est égal à Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également indexOf() et count().

int QStringRef::count() const

Renvoie le nombre de caractères auxquels fait référence la référence de chaîne. Équivalent à ` size()` et ` length()`.

Voir également position() et string().

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

Renvoie le nombre d'occurrences (pouvant se chevaucher) de la chaîne « str » dans cette référence de chaîne.

Si cs est défini sur Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::count(), contains() et indexOf().

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

Renvoie le nombre d'occurrences du caractère ch dans la référence de chaîne.

Si cs est défini sur Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::count(), contains() et indexOf().

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

Renvoie le nombre d'occurrences (pouvant se chevaucher) de la référence de chaîne str dans cette référence de chaîne.

Si cs est Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::count(), contains() et indexOf().

QStringRef::const_reverse_iterator QStringRef::crbegin() const

Identique à rbegin().

Voir également begin(), rbegin() et rend().

QStringRef::const_reverse_iterator QStringRef::crend() const

Identique à rend().

Voir également end(), rend() et rbegin().

const QChar *QStringRef::data() const

Identique à ` unicode()`.

QStringRef::const_iterator QStringRef::end() const

Renvoie un itérateur de type STL (const) pointant vers le caractère imaginaire situé après le dernier caractère de la liste.

Voir également cbegin(), constBegin(), end(), constEnd(), rbegin() et rend().

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

Renvoie « true » si la référence de chaîne se termine par « str » ; sinon, renvoie « false ».

Si cs vaut Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::endsWith() et startsWith().

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

Renvoie « true » si la référence de chaîne se termine par « ch » ; sinon, renvoie « false ».

Si cs vaut Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::endsWith() et endsWith().

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

Voir également QString::endsWith() et endsWith().

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

Voir également QString::endsWith() et startsWith().

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

Voir également QString::endsWith() et endsWith().

QChar QStringRef::front() const

Renvoie le premier caractère de la chaîne. Équivalent à ` at(0)`.

Cette fonction est fournie à des fins de compatibilité avec la STL.

Voir également back(), at() et operator[]().

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

Renvoie l'index de la première occurrence de la chaîne « str » dans cette référence de chaîne, en effectuant la recherche vers l'avant à partir de l'index « from ». Renvoie -1 si « str » n'est pas trouvé.

Si cs est égal à Qt::CaseSensitive (valeur par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Si from vaut -1, la recherche commence au dernier caractère ; si elle vaut -2, elle commence à l'avant-dernier caractère, et ainsi de suite.

Voir également QString::indexOf(), lastIndexOf(), contains() et count().

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

Renvoie l'index de la première occurrence de la chaîne « str » dans cette référence de chaîne, en effectuant la recherche vers l'avant à partir de l'index « from ». Renvoie -1 si « str » n'est pas trouvé.

Si cs est égal à Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Si from vaut -1, la recherche commence au dernier caractère ; si elle vaut -2, elle commence à l’avant-dernier caractère, et ainsi de suite.

Voir également QString::indexOf(), lastIndexOf(), contains() et count().

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

Renvoie l'indice de la première occurrence du caractère « ch » dans la référence de chaîne, en effectuant une recherche vers l'avant à partir de l'indice « from ». Renvoie -1 si « ch » est introuvable.

Voir également QString::indexOf(), lastIndexOf(), contains() et count().

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

Renvoie l'index de la première occurrence de la chaîne « view str » dans cette référence de chaîne, en effectuant la recherche vers l'avant à partir de l'index « from ». Renvoie -1 si « str » n'est pas trouvé.

Si cs est égal à Qt::CaseSensitive (valeur par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Si from vaut -1, la recherche commence au dernier caractère ; si elle vaut -2, à l'avant-dernier caractère, et ainsi de suite.

Voir également QString::indexOf(), QStringView::indexOf(), lastIndexOf(), contains() et count().

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

Renvoie l'index de la première occurrence de la référence de chaîne str dans cette référence de chaîne, en effectuant la recherche vers l'avant à partir de l'index from. Renvoie -1 si str n'est pas trouvé.

Si cs est égal à Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::indexOf(), lastIndexOf(), contains() et count().

bool QStringRef::isEmpty() const

Renvoie « true » si la référence de chaîne ne contient aucun caractère ; sinon, renvoie « false ».

Une référence de chaîne est vide si sa taille est égale à zéro.

Voir également size().

bool QStringRef::isNull() const

Renvoie « true » si cette référence de chaîne ne fait pas référence à une chaîne ou si la chaîne à laquelle elle fait référence est nulle (c'est-à-dire si QString::isNull() renvoie vrai).

Voir également size().

bool QStringRef::isRightToLeft() const

Renvoie true si la chaîne se lit de droite à gauche.

Voir aussi QString::isRightToLeft().

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

Renvoie l'index de la dernière occurrence de la chaîne « str » dans cette référence de chaîne, en effectuant une recherche vers l'arrière à partir de l'index « from ». Si « from » est égal à -1 (valeur par défaut), la recherche commence au dernier caractère ; si « from » est égal à -2, elle commence à l'avant-dernier caractère, et ainsi de suite. Renvoie -1 si « str » n'est pas trouvé.

Si cs vaut Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::lastIndexOf(), indexOf(), contains() et count().

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

Renvoie l’index de la dernière occurrence du caractère ch, en effectuant une recherche vers l’arrière à partir de la position from.

Voir également QString::lastIndexOf(), indexOf(), contains() et count().

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

Renvoie l'index de la dernière occurrence de la chaîne « str » dans cette référence de chaîne, en effectuant la recherche à rebours à partir de l'index « from ». Si « from » est égal à -1 (valeur par défaut), la recherche commence au dernier caractère ; si « from » est égal à -2, elle commence à l'avant-dernier caractère, et ainsi de suite. Renvoie -1 si « str » n'est pas trouvé.

Si cs vaut Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::lastIndexOf(), indexOf(), contains() et count().

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

Renvoie l'index de la dernière occurrence de la chaîne « view str » dans cette chaîne, en effectuant la recherche à rebours à partir de l'index « from ». Si « from » vaut -1 (valeur par défaut), la recherche commence au dernier caractère ; si « from » vaut -2, elle commence à l'avant-dernier caractère, et ainsi de suite. Renvoie -1 si « str » n'est pas trouvé.

Si cs vaut Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également indexOf(), contains() et count().

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

Renvoie l'index de la dernière occurrence de la référence de chaîne str dans cette référence de chaîne, en effectuant la recherche à rebours à partir de l'index from. Si from vaut -1 (par défaut), la recherche commence au dernier caractère ; si from vaut -2, elle commence à l'avant-dernier caractère, et ainsi de suite. Renvoie -1 si str n'est pas trouvée.

Si cs vaut Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::lastIndexOf(), indexOf(), contains() et count().

QStringRef QStringRef::left(int n) const

Renvoie une référence à la sous-chaîne correspondant aux n caractères situés le plus à gauche de la chaîne.

Si ` n ` est supérieur ou égal à ` size()`, ou inférieur à zéro, une référence à la chaîne entière est renvoyée.

Voir également right(), mid(), startsWith(), chopped(), chop() et truncate().

int QStringRef::length() const

Renvoie le nombre de caractères auxquels fait référence la référence de chaîne. Équivalent à size() et count().

Voir également position() et string().

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

Compare s1 à s2 et renvoie un entier négatif si s1 est inférieur à s2, un entier positif s'il est supérieur à s2, et zéro s'ils sont égaux.

La comparaison est effectuée en fonction des paramètres régionaux et de la plate-forme. Utilisez cette fonction pour présenter à l’utilisateur des listes de chaînes triées.

Voir également compare(), QLocale et Comparing Strings.

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

Compare *this avec other et renvoie un entier négatif si *this est inférieur à other, un entier positif s'il est supérieur à other, et zéro s'ils sont égaux.

La comparaison est effectuée en fonction des paramètres régionaux et de la plate-forme. Utilisez cette fonction pour présenter à l'utilisateur des listes de chaînes triées.

Voir également Comparing Strings.

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

Compare *this à other et renvoie un entier négatif si *this est inférieur à other, un entier positif s'il est supérieur à other, et zéro s'ils sont égaux.

La comparaison est effectuée en fonction des paramètres régionaux et de la plate-forme. Utilisez cette fonction pour présenter à l’utilisateur des listes de chaînes triées.

Voir également Comparing Strings.

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

Compare s1 à s2 et renvoie un entier négatif si s1 est inférieur à s2, un entier positif s'il est supérieur à s2, et zéro s'ils sont égaux.

La comparaison est effectuée en fonction des paramètres régionaux et de la plate-forme. Utilisez cette fonction pour présenter à l’utilisateur des listes de chaînes triées.

Voir également Comparing Strings.

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

Renvoie une référence à une sous-chaîne de n caractères de cette chaîne, à partir de l'position spécifiée.

Si l'position dépasse la longueur de la chaîne, une référence nulle est renvoyée.

Si l'position() résultante ne peut pas être représentée dans int, une QStringRef e nulle est renvoyée.

S’il y a moins de caractères n disponibles dans la chaîne, à partir de l’ position donné, ou si n est égal à -1 (valeur par défaut), la fonction renvoie tous les caractères à partir de l’ position spécifié.

Voir également left(), right(), chopped(), chop() et truncate().

int QStringRef::position() const

Renvoie la position de départ dans la chaîne référencée à laquelle renvoie la référence de chaîne.

Voir également size() et string().

QStringRef::const_reverse_iterator QStringRef::rbegin() const

Renvoie un itérateur inversé de type STL (const) pointant vers le premier caractère de la chaîne, dans l'ordre inverse.

Voir également begin(), crbegin() et rend().

QStringRef::const_reverse_iterator QStringRef::rend() const

Renvoie un itérateur inversé de type STL pointant sur le caractère situé juste après le dernier caractère de la chaîne, dans l'ordre inverse.

Voir également end(), crend() et rbegin().

QStringRef QStringRef::right(int n) const

Renvoie une référence à la sous-chaîne correspondant aux n caractères situés le plus à droite de la chaîne.

Si ` n ` est supérieur ou égal à ` size()`, ou inférieur à zéro, une référence à la chaîne entière est renvoyée.

Si la nouvelle valeur de ` position()` ne peut pas être représentée dans ` int`, une référence à la chaîne entière est renvoyée.

Voir également left(), mid(), endsWith(), chopped(), chop() et truncate().

int QStringRef::size() const

Renvoie le nombre de caractères auxquels fait référence la référence de chaîne. Équivalent à length() et count().

Voir également position() et string().

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

Divise la chaîne en sous-chaînes contenant des occurrences de « sep » et renvoie la liste de ces sous-chaînes.

Voir la fonction ` QString::split()` pour comprendre comment ` sep`, ` behavior ` et ` cs ` interagissent pour former le résultat.

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

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

Renvoie « true » si la référence de chaîne commence par « str » ; sinon, renvoie « false ».

Si cs est égal à Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::startsWith() et endsWith().

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

Renvoie « true » si la référence de chaîne commence par « ch » ; sinon, renvoie « false ».

Si cs vaut Qt::CaseSensitive (par défaut), la recherche tient compte de la casse ; sinon, elle ne tient pas compte de la casse.

Voir également QString::startsWith() et endsWith().

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

Voir également QString::startsWith() et endsWith().

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

Voir également QString::startsWith() et endsWith().

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

Voir également QString::startsWith() et endsWith().

const QString *QStringRef::string() const

Renvoie un pointeur vers la chaîne à laquelle fait référence la référence de chaîne, ou 0 si celle-ci ne fait référence à aucune chaîne.

Voir également unicode().

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

Renvoie la chaîne convertie en une valeur de type ` double `.

Renvoie l'infini si la conversion provoque un débordement, ou 0,0 si la conversion échoue pour d'autres raisons (par exemple, un sous-débordement).

Si ok n'est pas nullptr, l'échec est signalé en définissant *ok sur false, et la réussite en définissant *ok sur true.

La conversion de chaîne s'effectue toujours selon les paramètres régionaux « C ». Pour une conversion dépendante des paramètres régionaux, utilisez QLocale::toDouble()

Pour des raisons historiques, cette fonction ne gère pas les séparateurs de milliers. Si vous avez besoin de convertir de tels nombres, utilisez QLocale::toDouble().

Voir également QString::toDouble().

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

Renvoie la chaîne convertie en une valeur de type ` float `.

Renvoie l'infini si la conversion provoque un débordement, ou 0,0 si la conversion échoue pour d'autres raisons (par exemple, un sous-débordement).

Si ok n'est pas nullptr, l'échec est signalé en définissant *ok sur false, et la réussite en définissant *ok sur true.

La conversion de chaîne s'effectuera toujours selon les paramètres régionaux « C ». Pour une conversion dépendante des paramètres régionaux, utilisez QLocale::toFloat()

Voir également QString::toFloat().

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

Renvoie la chaîne convertie en un format « int » en utilisant la base base, qui est de 10 par défaut et doit être comprise entre 2 et 36, ou 0. Renvoie 0 si la conversion échoue.

Si ` ok ` n'est pas ` nullptr`, l'échec est signalé en définissant *`ok ` sur ` false`, et la réussite en définissant *`ok ` sur ` true`.

Si base vaut 0, la convention du langage C est utilisée : si la chaîne commence par « 0x », la base 16 est utilisée ; si la chaîne commence par « 0 », la base 8 est utilisée ; sinon, la base 10 est utilisée.

La conversion de la chaîne s'effectuera toujours selon la locale « C ». Pour une conversion dépendante de la locale, utilisez QLocale::toInt()

Voir également QString::toInt().

QByteArray QStringRef::toLatin1() const

Renvoie une représentation Latin-1 de la chaîne sous la forme d'un tableau d'octets ( QByteArray).

Le tableau d'octets renvoyé n'est pas défini si la chaîne contient des caractères non Latin-1. Ces caractères peuvent être supprimés ou remplacés par un point d'interrogation.

Voir également toUtf8(), toLocal8Bit() et QStringEncoder.

QByteArray QStringRef::toLocal8Bit() const

Renvoie la représentation locale sur 8 bits de la chaîne sous la forme d'un tableau de caractères QByteArray. Le tableau d'octets renvoyé n'est pas défini si la chaîne contient des caractères non pris en charge par le codage local sur 8 bits.

Sur les systèmes Unix, cela équivaut à ` toUtf8()`, tandis que sous Windows, c'est la page de codes actuelle du système qui est utilisée.

Si cette chaîne contient des caractères ne pouvant pas être encodés dans la locale, le tableau d’octets renvoyé est indéfini. Ces caractères peuvent être supprimés ou remplacés par d’autres.

Voir également toLatin1(), toUtf8() et QStringEncoder.

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

Renvoie la chaîne convertie au format « long » en utilisant la base base, qui est de 10 par défaut et doit être comprise entre 2 et 36, ou égale à 0. Renvoie 0 si la conversion échoue.

Si ` ok ` n’est pas ` nullptr`, l’échec est signalé en définissant *`ok ` sur ` false`, et la réussite en définissant *`ok ` sur ` true`.

Si base vaut 0, la convention du langage C est utilisée : si la chaîne commence par « 0x », la base 16 est utilisée ; si la chaîne commence par « 0 », la base 8 est utilisée ; sinon, la base 10 est utilisée.

La conversion de la chaîne s'effectuera toujours selon la locale « C ». Pour une conversion dépendante de la locale, utilisez QLocale::toLong()

Voir également QString::toLong().

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

Renvoie la chaîne convertie en un format « long long » en utilisant la base base, qui est de 10 par défaut et doit être comprise entre 2 et 36, ou 0. Renvoie 0 si la conversion échoue.

Si ` ok ` n’est pas ` nullptr`, l’échec est signalé en définissant *`ok ` sur ` false`, et la réussite en définissant *`ok ` sur ` true`.

Si base vaut 0, la convention du langage C est utilisée : si la chaîne commence par « 0x », la base 16 est utilisée ; si la chaîne commence par « 0 », la base 8 est utilisée ; sinon, la base 10 est utilisée.

La conversion de la chaîne s'effectuera toujours selon la locale « C ». Pour une conversion dépendante de la locale, utilisez QLocale::toLongLong()

Voir également QString::toLongLong().

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

Renvoie la chaîne convertie au format « short » en utilisant la base base, qui est de 10 par défaut et doit être comprise entre 2 et 36, ou 0. Renvoie 0 si la conversion échoue.

Si ` ok ` n’est pas ` nullptr`, l’échec est signalé en définissant *`ok ` sur ` false`, et la réussite en définissant *`ok ` sur ` true`.

Si base vaut 0, la convention du langage C est utilisée : si la chaîne commence par « 0x », la base 16 est utilisée ; si la chaîne commence par « 0 », la base 8 est utilisée ; sinon, la base 10 est utilisée.

La conversion de la chaîne s'effectuera toujours selon la locale « C ». Pour une conversion dépendante de la locale, utilisez QLocale::toShort()

Voir également QString::toShort().

QString QStringRef::toString() const

Renvoie une copie de la référence de chaîne sous la forme d'un objet ` QString `.

Si la référence à la chaîne n'est pas une référence complète à la chaîne (c'est-à-dire que position() vaut 0 et que size() est égal à string()->size()), cette fonction allouera une nouvelle chaîne à renvoyer.

Voir également string().

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

Renvoie la chaîne convertie en un « unsigned int » en utilisant la base base, qui est de 10 par défaut et doit être comprise entre 2 et 36, ou 0. Renvoie 0 si la conversion échoue.

Si ` ok ` n’est pas ` nullptr`, l’échec est signalé en définissant *`ok ` sur ` false`, et la réussite en définissant *`ok ` sur ` true`.

Si base est égal à 0, la convention du langage C est utilisée : si la chaîne commence par « 0x », la base 16 est utilisée ; si la chaîne commence par « 0 », la base 8 est utilisée ; sinon, la base 10 est utilisée.

La conversion de la chaîne s'effectue toujours selon les paramètres régionaux « C ». Pour une conversion dépendant des paramètres régionaux, utilisez QLocale::toUInt().

Voir également QString::toUInt().

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

Renvoie la chaîne convertie en un format « unsigned long » en utilisant la base base, qui est de 10 par défaut et doit être comprise entre 2 et 36, ou 0. Renvoie 0 si la conversion échoue.

Si ` ok ` n’est pas ` nullptr`, l’échec est signalé en définissant *`ok ` sur ` false`, et la réussite en définissant *`ok ` sur ` true`.

Si base est égal à 0, la convention du langage C est utilisée : si la chaîne commence par « 0x », la base 16 est utilisée ; si la chaîne commence par « 0 », la base 8 est utilisée ; sinon, la base 10 est utilisée.

La conversion de la chaîne s'effectuera toujours dans la locale « C ». Pour une conversion dépendante de la locale, utilisez QLocale::toULongLong()

Voir également QString::toULong().

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

Renvoie la chaîne convertie en un nombre « unsigned long long » en utilisant la base base, qui est de 10 par défaut et doit être comprise entre 2 et 36, ou 0. Renvoie 0 si la conversion échoue.

Si ok n’est pas nullptr, l’échec est signalé en définissant *ok sur false, et la réussite en définissant *ok sur true.

Si base vaut 0, la convention du langage C est utilisée : si la chaîne commence par « 0x », la base 16 est utilisée ; si la chaîne commence par « 0 », la base 8 est utilisée ; sinon, la base 10 est utilisée.

La conversion de la chaîne s'effectuera toujours selon les paramètres régionaux « C ». Pour une conversion dépendante des paramètres régionaux, utilisez QLocale::toULongLong()

Voir également QString::toULongLong().

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

Renvoie la chaîne convertie en un format « unsigned short » en utilisant la base base, qui est de 10 par défaut et doit être comprise entre 2 et 36, ou 0. Renvoie 0 si la conversion échoue.

Si ` ok ` n’est pas ` nullptr`, l’échec est signalé en définissant *`ok ` sur ` false`, et la réussite en définissant *`ok ` sur ` true`.

Si base vaut 0, la convention du langage C est utilisée : si la chaîne commence par « 0x », la base 16 est utilisée ; si la chaîne commence par « 0 », la base 8 est utilisée ; sinon, la base 10 est utilisée.

La conversion de la chaîne s'effectuera toujours selon la locale « C ». Pour une conversion dépendante de la locale, utilisez QLocale::toUShort()

Voir également QString::toUShort().

QList<uint> QStringRef::toUcs4() const

Renvoie une représentation UCS-4/UTF-32 de la chaîne sous la forme d’une valeur de type « QList » <uint>.

UCS-4 est un codec Unicode et est donc sans perte. Tous les caractères de cette chaîne seront encodés en UCS-4. Toute séquence invalide d'unités de code dans cette chaîne est remplacée par le caractère de remplacement Unicode (QChar::ReplacementCharacter, qui correspond à U+FFFD).

La liste renvoyée n’est pas terminée par \0.

Voir également toUtf8(), toLatin1(), toLocal8Bit() et QStringEncoder.

QByteArray QStringRef::toUtf8() const

Renvoie une représentation UTF-8 de la chaîne sous la forme d'un QByteArray.

UTF-8 est un codec Unicode capable de représenter tous les caractères d'une chaîne Unicode, comme QString.

Voir également toLatin1(), toLocal8Bit() et QStringEncoder.

QStringRef QStringRef::trimmed() const

Renvoie une chaîne dont les espaces blancs ont été supprimés au début et à la fin.

On entend par « espace blanc » tout caractère pour lequel la fonction QChar::isSpace() renvoie true. Cela inclut les caractères ASCII «\t », «\n », «\v », «\f », «\r » et « ».

Contrairement à ` QString::simplified()`, la fonction `trimmed()` ne modifie pas les espaces internes.

Si, après suppression des espaces, la nouvelle chaîne obtenue par ` position()` ne peut pas être représentée dans ` int`, le comportement est indéfini.

Voir également la fonction ` QString::trimmed()`.

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

Tronque la chaîne à l'index « position » indiqué.

Si l'indice de l'position spécifié se trouve au-delà de la fin de la chaîne, rien ne se passe.

Si position est négatif, cela revient à passer zéro.

Voir aussi QString::truncate().

const QChar *QStringRef::unicode() const

Renvoie une représentation Unicode de la référence de chaîne. Étant donné que les données proviennent directement de la chaîne référencée, elles ne sont pas terminées par un caractère « \0 » à moins que la référence de chaîne n’inclue le caractère de fin de chaîne nul.

Voir également string().

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

Le pointeur const char de type « s » est converti en « QStringRef » à l'aide de la fonction fromUtf8().

Vous pouvez désactiver cet opérateur en définissant ` QT_NO_CAST_FROM_ASCII ` lors de la compilation de vos applications. Cela peut s'avérer utile si vous souhaitez vous assurer que toutes les chaînes visibles par l'utilisateur passent par ` QObject::tr()`, par exemple.

Renvoie true si cette chaîne n'est pas lexicalement égale à la chaîne paramètre s. Sinon, renvoie false.

Voir également QT_NO_CAST_FROM_ASCII.

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

Le pointeur const char de type « s » est converti en « QStringRef » à l’aide de la fonction fromUtf8().

Vous pouvez désactiver cet opérateur en définissant ` QT_NO_CAST_FROM_ASCII ` lors de la compilation de vos applications. Cela peut s’avérer utile si vous souhaitez vous assurer que toutes les chaînes visibles par l’utilisateur passent par ` QObject::tr()`, par exemple.

Renvoie ` true ` si cette chaîne est lexicalement plus courte que la chaîne paramètre ` s`. Sinon, renvoie ` false`.

Voir également QT_NO_CAST_FROM_ASCII.

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

Le pointeur const char de type « s » est converti en « QStringRef » à l’aide de la fonction fromUtf8().

Vous pouvez désactiver cet opérateur en définissant ` QT_NO_CAST_FROM_ASCII ` lors de la compilation de vos applications. Cela peut s’avérer utile si vous souhaitez vous assurer que toutes les chaînes visibles par l’utilisateur passent par ` QObject::tr()`, par exemple.

Renvoie ` true ` si cette chaîne est lexicalement inférieure ou égale à la chaîne paramètre ` s`. Sinon, renvoie ` false`.

Voir également QT_NO_CAST_FROM_ASCII.

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

Crée une référence de chaîne vers l'string donné et l'attribue à cette référence de chaîne, puis renvoie le résultat.

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

Attribue la référence de chaîne « other » à cette référence de chaîne, puis renvoie le résultat.

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

Le tableau d'octets « s » est converti en « QStringRef » à l'aide de la fonction fromUtf8(). Cette fonction interrompt la conversion dès qu'elle rencontre le premier caractère NUL ou à la fin du tableau d'octets.

Vous pouvez désactiver cet opérateur en définissant ` QT_NO_CAST_FROM_ASCII ` lors de la compilation de vos applications. Cela peut s’avérer utile si vous souhaitez vous assurer que toutes les chaînes visibles par l’utilisateur passent par ` QObject::tr()`, par exemple.

Renvoie ` true ` si cette chaîne est lexicalement égale à la chaîne paramétrique ` s`. Sinon, renvoie ` false`.

Voir également QT_NO_CAST_FROM_ASCII.

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

Le pointeur `const char` de type ` s ` est converti en ` QStringRef ` à l'aide de la fonction `fromUtf8()`.

Vous pouvez désactiver cet opérateur en définissant ` QT_NO_CAST_FROM_ASCII ` lors de la compilation de vos applications. Cela peut s’avérer utile si vous souhaitez vous assurer que toutes les chaînes visibles par l’utilisateur passent par ` QObject::tr()`, par exemple.

Renvoie ` true ` si cette chaîne est lexicalement supérieure à la chaîne paramètre ` s`. Sinon, renvoie ` false`.

Voir également QT_NO_CAST_FROM_ASCII.

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

Le pointeur const char de type « s » est converti en un « QStringRef » à l’aide de la fonction fromUtf8().

Vous pouvez désactiver cet opérateur en définissant ` QT_NO_CAST_FROM_ASCII ` lors de la compilation de vos applications. Cela peut s’avérer utile si vous souhaitez vous assurer que toutes les chaînes visibles par l’utilisateur passent par ` QObject::tr()`, par exemple.

Renvoie ` true ` si cette chaîne est lexicalement supérieure ou égale à la chaîne paramètre ` s`. Sinon, renvoie ` false`.

Voir également QT_NO_CAST_FROM_ASCII.

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

Renvoie le caractère situé à l'index position dans la référence de chaîne.

L’ position doit correspondre à une position d’index valide dans la référence de chaîne (c’est-à-dire 0 <= position < size()).

Voir également at().