QStringRef Class

Documentation sur les fonctions membres

[constexpr noexcept] QStringRef::QStringRef()

Construit une référence de chaîne vide.

QStringRef::QStringRef(const QString *string)

Construit une référence de chaîne de caractères à l'adresse string.

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

Construit une chaîne de référence à la plage de caractères de l'adresse string spécifiée par les caractères de départ position et length.

Cela signifie que le début de position doit être positif ou 0 et inférieur à la longueur de string et que length doit être positif ou 0 mais inférieur à la longueur de la chaîne moins le début de position; c'est-à-dire que 0 <= position < chaîne->length() et 0 <= longueur <= chaîne->length() - position doivent tous deux être satisfaits.

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

Construit une copie de la référence de la chaîne other.

[noexcept default] QStringRef::~QStringRef()

Détruit la référence à la chaîne de caractères.

Étant donné que cette classe n'est utilisée que pour faire référence à des données de chaîne et qu'elle n'en prend pas possession, 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 combinées de la chaîne.

const QChar QStringRef::at(int position) const

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

L'adresse position doit être 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. Identique à at(size() - 1).

Cette fonction est fournie pour la compatibilité STL.

Voir aussi front(), at() et operator[]().

QStringRef::const_iterator QStringRef::begin() const

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

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

QStringRef::const_iterator QStringRef::cbegin() const

Identique à begin().

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

QStringRef::const_iterator QStringRef::cend() const

Identique à end().

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

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

Supprime les caractères n de 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 équivaut à passer zéro.

Voir aussi QString::chop() et truncate().

QStringRef QStringRef::chopped(int len) const

Renvoie une référence de sous-chaîne aux size() - len caractères les plus à gauche de cette chaîne.

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

void QStringRef::clear()

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

Voir aussi isEmpty() et isNull().

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

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

Si cs est Qt::CaseSensitive, la comparaison est sensible à la casse ; sinon, la comparaison est insensible à 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 longueur un.

Si cs est Qt::CaseSensitive, la comparaison est sensible à la casse ; sinon, la comparaison est insensible à la casse.

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

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

Si cs est Qt::CaseSensitive, la comparaison est sensible à la casse ; sinon, la comparaison est insensible à la casse.

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

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é en UTF-8.

Si cs est Qt::CaseSensitive, la comparaison est sensible à la casse ; sinon, la comparaison est insensible à la casse.

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

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

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

Si cs est Qt::CaseSensitive, la comparaison est sensible à la casse ; sinon, la comparaison est insensible à la casse.

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

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

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

Si cs est Qt::CaseSensitive, la comparaison est sensible à la casse ; sinon, la comparaison est insensible à la casse.

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

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

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

Si cs est Qt::CaseSensitive, la comparaison est sensible à la casse ; sinon, la comparaison est insensible à la casse.

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

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

Si cs est Qt::CaseSensitive, la comparaison est sensible à la casse ; sinon, la comparaison est insensible à la casse.

QStringRef::const_iterator QStringRef::constBegin() const

Identique à begin().

Voir aussi begin(), cend(), constEnd(), rbegin() et rend().

const QChar *QStringRef::constData() const

Identique à unicode().

QStringRef::const_iterator QStringRef::constEnd() const

Identique à end().

Voir aussi 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 est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi indexOf() et count().

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à 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 Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi 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 vue de chaîne str; sinon, renvoie false.

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi 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 Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi indexOf() et count().

int QStringRef::count() const

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

Voir aussi 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 Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi 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 chaîne de référence.

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi 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 est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi 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 constant de style STL pointant vers le caractère imaginaire situé après le dernier caractère de la liste.

Voir aussi 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 la chaîne se termine par str; sinon, renvoie false.

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi QString::endsWith() et startsWith().

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi QString::endsWith() et endsWith().

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

Voir aussi QString::endsWith() et endsWith().

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

Voir aussi QString::endsWith() et startsWith().

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

Voir aussi QString::endsWith() et endsWith().

QChar QStringRef::front() const

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

Cette fonction est fournie pour la compatibilité STL.

Voir aussi back(), at() et operator[]().

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

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

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

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

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

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

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

Renvoie la position d'index de la première occurrence du caractère ch dans la référence de la chaîne, en effectuant une recherche vers l'avant à partir de la position d'index from. Retourne -1 si ch n'a pas été trouvé.

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

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

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

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

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

Renvoie la position d'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 une recherche vers l'avant à partir de la position d'index from. Retourne -1 si str n'est pas trouvé.

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

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

bool QStringRef::isEmpty() const

Renvoie true si la référence de chaîne n'a pas de caractères ; sinon, renvoie false.

Une référence de chaîne est vide si sa taille est nulle.

Voir aussi 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 qu'elle référence est nulle (c'est-à-dire que QString::isNull() est vrai).

Voir aussi size().

bool QStringRef::isRightToLeft() const

Renvoie true si la chaîne est lue de droite à gauche.

Voir aussi QString::isRightToLeft().

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

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

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

Renvoie la position d'index de la dernière occurrence du caractère ch, en effectuant une recherche à rebours à partir de la position from.

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

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

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

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

Renvoie la position d'index de la dernière occurrence de la vue de la chaîne str dans cette chaîne, en effectuant une recherche à rebours à partir de la position d'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. Retourne -1 si str n'est pas trouvé.

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi indexOf(), contains() et count().

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

Renvoie la position d'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 une recherche à rebours à partir de la position d'index from. Si from est -1 (valeur par défaut), la recherche commence au dernier caractère ; si from est -2, à l'avant-dernier caractère et ainsi de suite. Retourne -1 si str n'est pas trouvé.

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

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

QStringRef QStringRef::left(int n) const

Renvoie une référence de sous-chaîne aux n caractères les 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 aussi right(), mid(), startsWith(), chopped(), chop() et truncate().

int QStringRef::length() const

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

Voir aussi position() et string().

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

Compare s1 avec s2 et renvoie un nombre entier négatif si s1 est inférieur à s2, un nombre 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 locaux et de la plate-forme. Utilisez cette fonction pour présenter à l'utilisateur des listes triées de chaînes de caractères.

Voir aussi compare(), QLocale, et Comparing Strings.

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

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

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

Voir également Comparing Strings.

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

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

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

Voir également Comparing Strings.

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

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

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

Voir également Comparing Strings.

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

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

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

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

Voir aussi left(), right(), chopped(), chop() et truncate().

int QStringRef::position() const

Renvoie la position de départ de la chaîne référencée à laquelle se réfère la référence de chaîne.

Voir aussi size() et string().

QStringRef::const_reverse_iterator QStringRef::rbegin() const

Renvoie un itérateur inverse de style STL constant pointant sur le premier caractère de la chaîne, dans l'ordre inverse.

Voir aussi begin(), crbegin(), et rend().

QStringRef::const_reverse_iterator QStringRef::rend() const

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

Voir aussi end(), crend(), et rbegin().

QStringRef QStringRef::right(int n) const

Renvoie une référence de sous-chaîne aux n caractères les 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.

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

int QStringRef::size() const

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

Voir aussi 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 de référence à chaque fois que sep apparaît, et renvoie la liste de ces chaînes.

Voir QString::split() pour savoir 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 la chaîne commence par str; sinon, renvoie false.

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi QString::startsWith() et endsWith().

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à la casse.

Voir aussi QString::startsWith() et endsWith().

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

Voir aussi QString::startsWith() et endsWith().

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

Voir aussi QString::startsWith() et endsWith().

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

Voir aussi QString::startsWith() et endsWith().

const QString *QStringRef::string() const

Renvoie un pointeur sur la chaîne de caractères à laquelle la référence de chaîne fait référence, ou 0 si elle ne fait pas référence à une chaîne de caractères.

Voir également unicode().

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

Renvoie la chaîne de caractères convertie en valeur double.

Renvoie une infinité si la conversion déborde ou 0.0 si la conversion échoue pour d'autres raisons (par exemple, un débordement).

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

La conversion des chaînes de caractères se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toDouble()

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

Voir aussi QString::toDouble().

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

Renvoie la chaîne de caractères convertie en valeur float.

Renvoie une infinité si la conversion déborde ou 0.0 si la conversion échoue pour d'autres raisons (par exemple, un débordement).

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

La conversion des chaînes de caractères se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toFloat()

Voir aussi QString::toFloat().

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

Renvoie la chaîne convertie en int en utilisant la base base, qui est 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é par la définition de *ok en false, et la réussite par la définition de *ok en true.

Si base est 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 se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toInt()

Voir aussi QString::toInt().

QByteArray QStringRef::toLatin1() const

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

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

Voir aussi toUtf8(), toLocal8Bit(), et QStringEncoder.

QByteArray QStringRef::toLocal8Bit() const

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

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

Si cette chaîne contient des caractères qui ne peuvent 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 aussi toLatin1(), toUtf8(), et QStringEncoder.

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

Renvoie la chaîne convertie en long en utilisant la base base, qui est 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é par la définition de *ok en false, et la réussite par la définition de *ok en true.

Si base est 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 se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toLong()

Voir aussi QString::toLong().

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

Renvoie la chaîne convertie en long long en utilisant la base base, qui est 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é par la définition de *ok en false, et la réussite par la définition de *ok en true.

Si base est 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 se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toLongLong()

Voir aussi QString::toLongLong().

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

Renvoie la chaîne convertie en short en utilisant la base base, qui est 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é par la définition de *ok en false, et la réussite par la définition de *ok en true.

Si base est 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 se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toShort()

Voir aussi QString::toShort().

QString QStringRef::toString() const

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

Si la référence de la chaîne n'est pas une référence complète de 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 aussi string().

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

Renvoie la chaîne convertie en unsigned int en utilisant la base base, qui est 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é par la définition de *ok en false, et la réussite par la définition de *ok en 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 se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toUInt()

Voir aussi QString::toUInt().

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

Renvoie la chaîne convertie en unsigned long en utilisant la base base, qui est 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é par la définition de *ok en false, et la réussite par la définition de *ok en true.

Si base est 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 se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toULongLong()

Voir aussi QString::toULong().

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

Renvoie la chaîne convertie en unsigned long long en utilisant la base base, qui est 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é par la définition de *ok en false, et la réussite par la définition de *ok en true.

Si base est 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 se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toULongLong()

Voir aussi QString::toULongLong().

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

Renvoie la chaîne convertie en unsigned short en utilisant la base base, qui est 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é par la définition de *ok en false, et la réussite par la définition de *ok en true.

Si base est 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 se fera toujours dans la locale 'C'. Pour une conversion dépendante de la locale, utilisez QLocale::toUShort()

Voir aussi QString::toUShort().

QList<uint> QStringRef::toUcs4() const

Renvoie une représentation UCS-4/UTF-32 de la chaîne sous forme de 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 d'Unicode (QChar::ReplacementCharacter, qui correspond à U+FFFD).

La liste renvoyée n'est pas \0'-terminée.

Voir aussi toUtf8(), toLatin1(), toLocal8Bit() et QStringEncoder.

QByteArray QStringRef::toUtf8() const

Retourne une représentation UTF-8 de la chaîne sous forme de QByteArray.

UTF-8 est un codec Unicode et peut 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 de caractères dont les espaces blancs ont été supprimés au début et à la fin.

Par espacement, on entend tout caractère pour lequel QChar::isSpace() renvoie true. Cela inclut les caractères ASCII '\t', '\n', '\v', '\f', '\r' et ' '.

Contrairement à QString::simplified(), trimmed() ne touche pas aux espaces blancs internes.

Voir également QString::trimmed().

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

Tronque la chaîne de caractères à l'index position donné.

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

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

Voir aussi QString::truncate().

const QChar *QStringRef::unicode() const

Renvoie une représentation Unicode de la référence de la chaîne. Comme les données proviennent directement de la chaîne référencée, elles ne sont pas \0'-terminées, sauf si la référence à la chaîne inclut le terminateur nul de la chaîne.

Voir également string().

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

Le pointeur s const char 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 être utile si vous voulez 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, elle renvoie false.

Voir aussi QT_NO_CAST_FROM_ASCII.

bool QStringRef::operator<(const char *s) const

Le pointeur s const char 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 être utile si vous voulez 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 petite que la chaîne paramètre s. Sinon, elle renvoie false.

Voir aussi QT_NO_CAST_FROM_ASCII.

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

Le pointeur s const char 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 être utile si vous voulez 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 petite ou égale à la chaîne de paramètres s. Sinon, elle renvoie false.

Voir aussi QT_NO_CAST_FROM_ASCII.

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

Construit une référence de chaîne à l'adresse string donnée et l'affecte à cette référence de chaîne, en renvoyant le résultat.

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

Affecte la référence de chaîne other à cette référence de chaîne et renvoie le résultat.

bool QStringRef::operator==(const char *s) const

Le tableau d'octets s est converti en QStringRef à l'aide de la fonction fromUtf8(). Cette fonction arrête la conversion au premier caractère NUL trouvé, 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 être utile si vous voulez 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 de paramètre s. Sinon, elle renvoie false.

Voir aussi QT_NO_CAST_FROM_ASCII.

bool QStringRef::operator>(const char *s) const

Le pointeur s const char 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 être utile si vous voulez 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 grande que la chaîne paramètre s. Sinon, elle renvoie false.

Voir aussi QT_NO_CAST_FROM_ASCII.

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

Le pointeur s const char 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 être utile si vous voulez 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 de paramètre s. Sinon, elle renvoie false.

Voir aussi QT_NO_CAST_FROM_ASCII.

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

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

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

Voir également at().