QLatin1StringView Class

Documentation des fonctions membres

[constexpr noexcept] QLatin1StringView::QLatin1StringView()

Crée un objet QLatin1StringView qui stocke un nullptr.

Voir également data(), isEmpty(), isNull() et Distinction Between Null and Empty Strings.

[explicit constexpr noexcept, since 6.3] QLatin1StringView::QLatin1StringView(QByteArrayView str)

Crée un objet `QLatin1StringView` en tant que vue sur ` str`.

Les données de la chaîne ne sont pas copiées. L’appelant doit pouvoir garantir que les données vers lesquelles pointe str ne seront ni supprimées ni modifiées tant que l’objet QLatin1StringView existe. La taille est obtenue à partir de str telle quelle, sans vérification de la présence d’un caractère de fin de chaîne nul.

Cette fonction a été introduite dans Qt 6.3.

Voir également latin1().

[explicit noexcept] QLatin1StringView::QLatin1StringView(const QByteArray &str)

Crée un objet QLatin1StringView en tant que vue sur str.

Les données de chaîne ne sont pas copiées. L'appelant doit pouvoir garantir que str ne sera ni supprimé ni modifié tant que l'objet QLatin1StringView existe.

Voir aussi latin1().

[explicit constexpr noexcept] QLatin1StringView::QLatin1StringView(const char *str)

Crée un objet QLatin1StringView qui stocke str.

Les données de chaîne ne sont pas copiées. L'appelant doit pouvoir garantir que ` str ` ne sera ni supprimé ni modifié tant que l'objet `QLatin1StringView` existe.

Voir également latin1().

[constexpr noexcept, since 6.4] QLatin1StringView::QLatin1StringView(std::nullptr_t)

Crée un objet `QLatin1StringView` qui stocke un ` nullptr`.

Cette fonction a été introduite dans Qt 6.4.

Voir également data(), isEmpty(), isNull() et Distinction Between Null and Empty Strings.

[constexpr] QLatin1StringView::QLatin1StringView(const char *first, const char *last)

Crée un objet QLatin1StringView qui stocke la chaîne « first » d'une longueur de (last - first).

La plage [first,last) doit rester valide pendant toute la durée de vie de cet objet de chaîne Latin-1.

Le passage de ` nullptr ` comme ` first ` est sans risque si ` last ` est également ` nullptr`, et aboutit à une chaîne Latin-1 nulle.

Le comportement est indéfini si last précède first, si first est nullptr et last ne l'est pas, ou si last - first > INT_MAX.

[constexpr noexcept] QLatin1StringView::QLatin1StringView(const char *str, qsizetype size)

Crée un objet `QLatin1StringView` qui stocke ` str ` avec ` size`.

Les données de la chaîne ne sont pas copiées. L'appelant doit pouvoir garantir qu'str ne sera ni supprimé ni modifié tant que l'objet QLatin1StringView existe.

Voir également latin1().

template <typename... Args> QString QLatin1StringView::arg(Args &&... args) const

Remplace les occurrences de « %N » dans cette chaîne par l’argument correspondant issu de args. Les arguments ne sont pas positionnels : le premier élément de args remplace %N par la valeur la plus faible de N (toutes), le deuxième élément de args remplace %N par la valeur suivante la plus faible de N, etc.

Args peut être constituée de n’importe quel élément se convertissant implicitement en QAnyStringView.

Voir également QString::arg().

[constexpr] QLatin1Char QLatin1StringView::at(qsizetype pos) const

Renvoie le caractère situé à la position pos dans cet objet.

Voir également operator[]().

[constexpr] QLatin1Char QLatin1StringView::back() const

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

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

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

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::begin() const

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

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

Voir également end(), cbegin(), rbegin() et data().

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::cbegin() const

Identique à ` begin()`.

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

Voir également cend(), begin(), crbegin() et data().

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::cend() const

Identique à ` end()`.

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

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

[constexpr] void QLatin1StringView::chop(qsizetype length)

Tronque cette chaîne de caractères de length caractères.

Identique à ` *this = left(size() - length)`.

Voir également sliced(), first(), last(), chopped(), truncate() et slice().

[constexpr] QLatin1StringView QLatin1StringView::chopped(qsizetype length) const

Renvoie la sous-chaîne de longueur size() - length à partir du début de cet objet.

Identique à ` left(size() - length)`.

Voir également sliced(), first(), last(), chop(), truncate() et slice().

Compare cette représentation de chaîne avec la représentation UTF-16 str, la représentation Latin-1 l1 ou le caractère ch, respectivement. Renvoie un entier négatif si cette chaîne est inférieure à str, l1 ou ch; renvoie un entier positif si elle est supérieure à str, l1 ou ch; et renvoie zéro si elles sont égales.

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

Voir également operator==(), operator<() et operator>().

[noexcept, since 6.5] int QLatin1StringView::compare(QUtf8StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Compare cette vue de chaîne avec str et renvoie un entier négatif si cette vue de chaîne est inférieure à str, un entier positif si elle est supérieure à str, et zéro si elles sont égales.

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

Cette fonction a été introduite dans Qt 6.5.

Voir également operator==(), operator<() et operator>().

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constBegin() const

Identique à ` begin()`.

Cette fonction est fournie à des fins de compatibilité avec d'autres conteneurs Qt.

Cette fonction a été introduite dans Qt 6.4.

Voir également constEnd(), begin(), cbegin() et data().

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constData() const

Renvoie le début de la chaîne Latin-1 référencée par cet objet.

Cette fonction est fournie à des fins de compatibilité avec d’autres conteneurs Qt.

Cette fonction a été introduite dans Qt 6.4.

Voir également ` data()`.

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constEnd() const

Identique à end().

Cette fonction est fournie à des fins de compatibilité avec d’autres conteneurs Qt.

Cette fonction a été introduite dans Qt 6.4.

Voir également constBegin(), end(), cend() et crend().

Renvoie true si cette vue de chaîne Latin-1 contient une occurrence de la chaîne UTF-16 affichée par str, de la chaîne Latin-1 affichée par l1 ou du caractère ch, respectivement ; sinon, renvoie false.

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

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

Renvoie le nombre d’occurrences (pouvant se chevaucher) de la chaîne UTF-16 vue par str, de la chaîne Latin-1 vue par l1 ou du caractère ch, respectivement, dans cette vue de chaîne.

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.

Ces fonctions ont été introduites dans Qt 6.4.

Voir également contains() et indexOf().

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::crbegin() const

Identique à ` rbegin()`.

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

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

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::crend() const

Identique à ` rend()`.

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

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

[constexpr noexcept] const char *QLatin1StringView::data() const

Renvoie le début de la chaîne Latin-1 référencée par cet objet.

[constexpr noexcept, since 6.4] bool QLatin1StringView::empty() const

Indique si la chaîne Latin-1 référencée par cet objet est vide (size() == 0) ou non.

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

Cette fonction a été introduite dans Qt 6.4.

Voir également isEmpty(), isNull() et size().

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::end() const

Renvoie un itérateur const de type STL pointant juste après le dernier caractère de la chaîne.

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

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

Renvoie true si cette vue de chaîne Latin-1 se termine respectivement par la chaîne UTF-16 affichée par str, la chaîne Latin-1 affichée par l1 ou le caractère ch; sinon, renvoie false.

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

Voir également startsWith().

[constexpr, since 6.4] QLatin1Char QLatin1StringView::first() const

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

Cette fonction est fournie à des fins de compatibilité avec d'autres conteneurs Qt.

Cette fonction a été introduite dans Qt 6.4.

Voir également last(), front() et back().

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::first(qsizetype n) const

Renvoie une vue de chaîne Latin-1 contenant les n premiers caractères de cette vue de chaîne.

Cette fonction a été introduite dans Qt 6.0.

Voir également last(), startsWith(), chopped(), chop(), truncate() et slice().

[constexpr] QLatin1Char QLatin1StringView::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[]().

Renvoie la position d’index, dans cette vue de chaîne Latin-1, de la première occurrence de la chaîne UTF-16 vue par str, de la chaîne Latin-1 vue par l1 ou du caractère ch, respectivement, en effectuant une recherche vers l’avant à partir de la position d’index from. Renvoie -1 si str, l1 ou c n’est pas trouvé, respectivement.

Si cs vaut 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 ; s'il vaut -2, elle commence à l'avant-dernier caractère, et ainsi de suite.

Voir aussi QString::indexOf().

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

Indique si la chaîne Latin-1 référencée par cet objet est vide (size() == 0) ou non.

Voir également isNull() et size().

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

Indique si la chaîne Latin-1 référencée par cet objet est nulle (data() == nullptr) ou non.

Voir également isEmpty() et data().

[constexpr, since 6.4] QLatin1Char QLatin1StringView::last() const

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

Cette fonction est fournie à des fins de compatibilité avec d'autres conteneurs Qt.

Cette fonction a été introduite dans Qt 6.4.

Voir également first(), back() et front().

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::last(qsizetype n) const

Renvoie une vue de chaîne Latin-1 contenant les derniers caractères n de cette vue de chaîne.

Cette fonction a été introduite dans Qt 6.0.

Voir également first(), endsWith(), chopped(), chop(), truncate() et slice().

Renvoie la position d’index, dans cette vue de chaîne Latin-1, de la dernière occurrence de la chaîne UTF-16 vue par str, de la chaîne Latin-1 vue par l1 ou du caractère ch, respectivement, en effectuant une recherche vers l’arrière à partir de la position d’index from; renvoie -1 si str, l1 ou ch n’est pas trouvé, respectivement.

Si from est égal à -1, la recherche commence au dernier caractère ; s’il est égal à -2, elle commence à l’avant-dernier caractère, et ainsi de suite.

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

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

Renvoie la position d'index, dans cette vue de chaîne Latin-1, de la dernière occurrence de la chaîne UTF-16 affichée par str ou de la chaîne Latin-1 affichée par l1, respectivement. Renvoie -1 si str ou l1 n'est pas trouvé, respectivement.

Si cs correspond à Qt::CaseSensitive (valeur par défaut), la recherche tient compte de la casse ; dans le cas contraire, elle ne tient pas compte de la casse.

Ces fonctions ont été introduites dans Qt 6.2.

[constexpr noexcept] const char *QLatin1StringView::latin1() const

Renvoie le début de la chaîne Latin-1 référencée par cet objet.

[constexpr] QLatin1StringView QLatin1StringView::left(qsizetype length) const

Si vous savez que ` length ` ne peut pas être hors limites, utilisez plutôt ` first()` dans votre nouveau code, car cette fonction est plus rapide.

Renvoie la sous-chaîne de longueur length commençant à la position 0 dans cette vue de chaîne Latin-1.

La chaîne Latin-1 entière est renvoyée si length est supérieur ou égal à size(), ou inférieur à zéro.

Voir également first(), last(), sliced(), startsWith(), chopped(), chop(), truncate() et slice().

[constexpr noexcept, since 6.4] qsizetype QLatin1StringView::length() const

Identique à ` size()`.

Cette fonction est fournie à des fins de compatibilité avec d'autres conteneurs Qt.

Cette fonction a été introduite dans Qt 6.4.

[static constexpr noexcept, since 6.8] qsizetype QLatin1StringView::maxSize()

Elle renvoie le nombre maximal d'éléments que la vue de chaîne peut théoriquement représenter. En pratique, ce nombre peut être bien inférieur, car il est limité par la quantité de mémoire disponible sur le système.

Cette fonction a été introduite dans Qt 6.8.

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

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

Renvoie ` maxSize()`.

Cette fonction a été introduite dans Qt 6.8.

[constexpr] QLatin1StringView QLatin1StringView::mid(qsizetype start, qsizetype length = -1) const

Renvoie la sous-chaîne de longueur length commençant à la position start dans cette vue de chaîne Latin-1.

Si vous savez que start et length ne peuvent pas être hors limites, utilisez plutôt sliced() dans votre nouveau code, car cette méthode est plus rapide.

Renvoie une vue de chaîne Latin-1 vide si start dépasse la longueur de cette vue de chaîne. S'il y a moins de length caractères disponibles dans cette vue de chaîne à partir de start, ou si length est négatif (valeur par défaut), la fonction renvoie tous les caractères disponibles à partir de start.

Voir également first(), last(), sliced(), chopped(), chop(), truncate() et slice().

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::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.

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

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

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::rend() const

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

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

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

[constexpr] QLatin1StringView QLatin1StringView::right(qsizetype length) const

Si vous savez que ` length ` ne peut pas être hors limites, utilisez plutôt ` last()` dans votre nouveau code, car cette fonction est plus rapide.

Renvoie la sous-chaîne de longueur length commençant à la position size() - length dans cette vue de chaîne Latin-1.

La chaîne Latin-1 entière est renvoyée si length est supérieur ou égal à size(), ou inférieur à zéro.

Voir également first(), last(), sliced(), endsWith(), chopped(), chop(), truncate() et slice().

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

Renvoie la taille de la chaîne Latin-1 référencée par cet objet.

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

Modifie cette vue de chaîne Latin-1 pour qu'elle commence à la position pos et s'étende jusqu'à sa fin.

Cette fonction a été introduite dans Qt 6.8.

Voir également sliced(), first(), last(), chopped(), chop() et truncate().

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

Modifie cette chaîne de caractères Latin-1 pour qu'elle commence à la position pos et s'étende sur n caractères.

Cette fonction a été introduite dans Qt 6.8.

Voir également sliced(), first(), last(), chopped(), chop() et truncate().

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::sliced(qsizetype pos) const

Renvoie une vue de chaîne Latin-1 commençant à la position pos dans cette vue de chaîne, et s'étendant jusqu'à sa fin.

Cette fonction a été introduite dans Qt 6.0.

Voir également first(), last(), chopped(), chop(), truncate() et slice().

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::sliced(qsizetype pos, qsizetype n) const

Renvoie une vue de chaîne Latin-1 pointant vers n caractères de cette vue de chaîne, à partir de la position pos.

Cette fonction a été introduite dans Qt 6.0.

Voir également first(), last(), chopped(), chop(), truncate() et slice().

Renvoie « true » si cette vue de chaîne Latin-1 commence par la chaîne UTF-16 vue par « str », la chaîne Latin-1 vue par « l1 » ou le caractère « ch », respectivement ; sinon, renvoie « false ».

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.

Voir également endsWith().

Renvoie cette valeur « QLatin1StringView » convertie en une valeur à virgule flottante correspondante.

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 de type ` nullptr`, l'échec est signalé en définissant *`ok ` sur ` false`, et la réussite en définissant *`ok ` sur ` true`.

Cette fonction ignore les espaces en début et en fin de chaîne.

Ces fonctions ont été introduites dans Qt 6.4.

Renvoie cette chaîne « QLatin1StringView » convertie en une valeur numérique correspondante en utilisant la base base, qui est égale à 10 par défaut. Les bases 0 et 2 à 36 sont prises en charge, les lettres étant utilisées pour les chiffres supérieurs à 9 ; A correspond à 10, B à 11, et ainsi de suite.

Si ` base ` est égal à 0, la base est déterminée automatiquement selon les règles suivantes (dans cet ordre), si la chaîne Latin-1 commence par :

• "0x", le reste est interprété en hexadécimal (base 16)
• "0b", le reste est interprété en binaire (base 2)
• "0", le reste est interprété en octal (base 8)
• sinon, le reste est interprété en décimal

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.

Cette fonction ignore les espaces de début et de fin.

Ces fonctions ont été introduites dans Qt 6.4.

[since 6.0] QString QLatin1StringView::toString() const

Convertit cette chaîne Latin-1 en une chaîne « QString ». Équivalent à

return QString(*this);

Cette fonction a été introduite dans Qt 6.0.

Voir aussi toUtf8().

[since 6.9] QByteArray QLatin1StringView::toUtf8() const

Renvoie une représentation UTF-8 de la chaîne sous la forme d’un objet ` QByteArray`. Cette fonction est plus efficace que de convertir d’abord la chaîne en ` QString`.

Cette fonction a été introduite dans Qt 6.9.

Voir également toString() et QString::toUtf8().

[constexpr noexcept(...), since 6.0] template <typename Needle, typename... Flags> auto QLatin1StringView::tokenize(Needle &&sep, Flags... flags) const

Divise la chaîne en sous-chaînes à chaque occurrence d’ sep, puis renvoie une séquence « paresseuse » de ces chaînes.

Équivalent à

return QStringTokenizer{std::forward<Needle>(sep), flags...};

sauf qu’il fonctionne sans que la déduction des arguments de modèle de classe (CTAD) de C++17 soit activée dans le compilateur.

Voir QStringTokenizer pour comprendre comment sep et flags interagissent pour former le résultat.

QStringTokenizer result = sv.tokenize(sep);

(sans arguments de modèle). Si vous ne pouvez pas utiliser la CTAD de C++17, vous devez stocker la valeur de retour uniquement dans des variables de type ` auto ` :

auto result = sv.tokenize(sep);

En effet, les arguments de modèle de ` QStringTokenizer ` dépendent de manière très subtile de la surcharge spécifique de ` tokenize()` à partir de laquelle ils sont renvoyés, et ils ne correspondent généralement pas au type utilisé pour le séparateur.

Ces fonctions ont été introduites dans Qt 6.0.

Voir également QStringTokenizer et qTokenize().

[noexcept] QLatin1StringView QLatin1StringView::trimmed() const

Supprime les espaces blancs en début et en fin de chaîne, puis renvoie le résultat.

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

[constexpr] void QLatin1StringView::truncate(qsizetype length)

Tronque cette chaîne à la longueur length.

Identique à ` *this = left(length)`.

Voir également sliced(), first(), last(), chopped() et chop().

[constexpr] QLatin1Char QLatin1StringView::operator[](qsizetype pos) const

Renvoie le caractère situé à la position pos dans cet objet.

Voir également at().