QLatin1StringView Class

Documentation sur les fonctions membres

[constexpr noexcept] QLatin1StringView::QLatin1StringView()

Construit un objet QLatin1StringView qui stocke un nullptr.

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

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

Construit un objet QLatin1StringView en tant que vue sur str.

Les données de la chaîne ne sont pas copiées. L'appelant doit être en mesure de garantir que les données vers lesquelles str pointe ne seront ni supprimées ni modifiées tant que l'objet QLatin1StringView existera. La taille est obtenue telle quelle à partir de str, sans vérifier la présence d'un terminateur nul.

Cette fonction a été introduite dans Qt 6.3.

Voir aussi latin1().

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

Construit 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 str ne sera pas supprimé ou modifié tant que l'objet QLatin1StringView existera.

Voir également latin1().

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

Construit un objet QLatin1StringView qui stocke str.

Les données de la 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 existera.

Voir également latin1().

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

Construit un objet QLatin1StringView qui stocke un nullptr.

Cette fonction a été introduite dans Qt 6.4.

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

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

Construit un objet QLatin1StringView qui stocke first avec la longueur (last - first).

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

Transmettre nullptr en tant que first est sans danger si last est également nullptr et donne une chaîne Latin-1 nulle.

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

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

Construit 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 que str ne sera pas supprimé ou modifié tant que l'objet QLatin1StringView existera.

Voir aussi latin1().

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

Remplace les occurrences de %N dans cette chaîne par l'argument correspondant de args. Les arguments ne sont pas positionnels : le premier des args remplace le %N par le N le plus bas (tous), le deuxième des args le %N par le N le plus bas suivant, etc.

Args peut consister en tout ce qui se convertit implicitement en QAnyStringView.

Voir aussi QString::arg().

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

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

Voir aussi operator[]().

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

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

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

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

Voir aussi end(), cbegin(), rbegin() et data().

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

Identique à begin().

Cette fonction est fournie pour la compatibilité STL.

Voir aussi cend(), begin(), crbegin() et data().

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

Identique à end().

Cette fonction est fournie pour la compatibilité STL.

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

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

Tronque cette chaîne de length caractères.

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

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

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

Renvoie la sous-chaîne de longueur size() - length commençant au début de cet objet.

Identique à left(size() - length).

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

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

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

Cette fonction a été introduite dans Qt 6.5.

Voir aussi 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 aussi constEnd(), begin(), cbegin(), et data().

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

Renvoie le début de la chaîne de caractères 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 aussi 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 aussi constBegin(), end(), cend(), et crend().

Renvoie true si cette vue de chaîne latine-1 contient une occurrence de la chaîne UTF-16 vue par str, de la chaîne latine-1 vue par l1, ou du caractère ch, respectivement ; 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(), 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 Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à 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 pour la compatibilité STL.

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

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

Identique à rend().

Cette fonction est fournie pour la compatibilité STL.

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

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

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

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

Retourne 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é STL.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi isEmpty(), isNull(), et size().

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

Renvoie un itérateur de style STL qui pointe juste après le dernier caractère de la chaîne.

Cette fonction est fournie pour la compatibilité STL.

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

Renvoie true si cette vue de chaîne latine-1 se termine par la chaîne UTF-16 vue par str, la chaîne latine-1 vue par l1, ou le caractère ch, respectivement ; 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 startsWith().

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

Renvoie le premier caractère de la chaîne. Identique à 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 aussi last(), front(), et back().

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

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

Cette fonction a été introduite dans Qt 6.0.

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

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

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 cherchant vers l'avant à partir de la position d'index from. Retourne -1 si str, l1 ou c n'est pas trouvé, respectivement.

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().

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

Retourne 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

Retourne 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. Identique à 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 aussi first(), back(), et front().

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

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

Cette fonction a été introduite dans Qt 6.0.

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

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

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

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

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

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

Si cs est Qt::CaseSensitive (par défaut), la recherche est sensible à la casse ; sinon, la recherche est insensible à 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 de caractères 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 first() à la place dans votre nouveau code, car c'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 vue entière de la chaîne Latin-1 est retournée si length est supérieur ou égal à size(), ou inférieur à zéro.

Voir aussi 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 chaîne peut théoriquement représenter. En pratique, ce nombre peut être beaucoup plus petit, limité par la quantité de mémoire disponible dans 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 pour la compatibilité STL.

Retourne 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 sliced() à la place dans le nouveau code, car c'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 (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 inverse de style STL pointant sur le premier caractère de la chaîne, dans l'ordre inverse.

Cette fonction est fournie pour la compatibilité STL.

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

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

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

Cette fonction est fournie pour la compatibilité STL.

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

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

Si vous savez que length ne peut pas être hors limites, utilisez last() à la place dans votre nouveau code, car c'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 vue entière de la chaîne Latin-1 est retournée si length est supérieur ou égal à size(), ou inférieur à zéro.

Voir aussi 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 de caractères latine-1 pour qu'elle commence à la position pos et s'étende jusqu'à la fin.

Cette fonction a été introduite dans Qt 6.8.

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

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

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

Cette fonction a été introduite dans Qt 6.8.

Voir aussi 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 aussi 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 qui pointe 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 aussi first(), last(), chopped(), chop(), truncate() et slice().

Renvoie true si cette vue de chaîne latine-1 commence par la chaîne UTF-16 vue par str, la chaîne latine-1 vue par l1, ou le caractère ch, respectivement ; 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 endsWith().

Renvoie cette adresse QLatin1StringView convertie en une valeur flottante correspondante.

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 l'affectation de *ok à false, et la réussite par l'affectation de *ok à true.

Cette fonction ignore les caractères d'espacement de début et de fin.

Ces fonctions ont été introduites dans Qt 6.4.

Renvoie cette adresse QLatin1StringView convertie en une valeur numérique correspondante en utilisant la base base, qui est dix par défaut. Les bases 0 et 2 à 36 sont supportées, en utilisant des lettres pour les chiffres au-delà de 9 ; A est dix, B est onze et ainsi de suite.

Si base vaut 0, la base est déterminée automatiquement à l'aide des règles suivantes (dans cet ordre) : si la vue de la chaîne Latin-1 commence par :

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

Retourne 0 si la conversion échoue.

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

Cette fonction ignore les caractères d'espacement 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 de caractères Latin-1 en une chaîne de caractères 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 forme de QByteArray. Cette fonction est plus efficace que la conversion en QString.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi 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 fois que sep apparaît, et renvoie une séquence paresseuse de ces chaînes.

Équivalent à

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

sauf qu'il fonctionne sans la déduction d'argument de modèle de classe C++17 (CTAD) activée dans le compilateur.

Voir QStringTokenizer pour savoir 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 C++17, vous devez stocker la valeur de retour uniquement dans les variables auto:

auto result = sv.tokenize(sep);

En effet, les arguments de modèle de QStringTokenizer dépendent très subtilement 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 aussi QStringTokenizer et qTokenize().

[noexcept] QLatin1StringView QLatin1StringView::trimmed() const

Supprime les espaces blancs de début et de fin et renvoie le résultat.

Par espace blanc, on entend tout caractère pour lequel QChar::isSpace() renvoie 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 aussi sliced(), first(), last(), chopped() et chop().

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

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

Voir également at().