QStringView Class

Documentation des fonctions membres

[constexpr noexcept] QStringView::QStringView()

Crée une vue de chaîne vide.

Voir aussi isNull().

[constexpr noexcept] template <typename Char, size_t N> QStringView::QStringView(const Char (&string)[N])

Crée une vue de chaîne à partir du littéral de chaîne « string ». La vue couvre le tableau jusqu’à ce que le premier « Char(0) » soit rencontré, ou jusqu’à « N », selon la première éventualité. Si vous avez besoin du tableau complet, utilisez plutôt « fromArray() ».

string doit rester valide pendant toute la durée de vie de cet objet de vue de chaîne.

Contraintes

Ne participe à la résolution des surcharges que si Char est un type de caractère compatible. Les types de caractères compatibles sont : QChar, ushort, char16_t et (sur les plateformes, telles que Windows, où il s’agit d’un type 16 bits) wchar_t.

Voir également fromArray.

[constexpr noexcept] template <typename Char> QStringView::QStringView(const Char *str)

Crée une vue de chaîne sur str. La longueur est déterminée en recherchant le premier élément « Char(0) ».

str doit rester valide pendant toute la durée de vie de cet objet de vue de chaîne.

Le fait de passer nullptr comme str est sans risque et donne lieu à une vue de chaîne vide.

Contraintes

Ne participe à la résolution des surcharges que si Char est un type de caractère compatible. Les types de caractères compatibles sont : QChar, ushort, char16_t et (sur les plateformes, telles que Windows, où il s’agit d’un type 16 bits) wchar_t.

[constexpr noexcept] template <typename Container, QStringView::if_compatible_container<Container> = true> QStringView::QStringView(const Container &str)

Crée une vue de chaîne sur str. La longueur est extraite de std::size(str).

std::data(str) doit rester valide pendant toute la durée de vie de cet objet de vue de chaîne.

La vue de chaîne sera vide si et seulement si std::size(str) == 0. Il n’est pas spécifié si ce constructeur peut aboutir à une vue de chaîne nulle (std::data(str) devrait alors renvoyer nullptr ).

Contraintes

Ne participe à la résolution des surcharges que si ` Container ` est un conteneur dont le type de caractère est compatible avec celui de ` value_type`. Les types de caractères compatibles sont : ` QChar`, ` ushort`, ` char16_t ` et (sur les plateformes telles que Windows, où il s’agit d’un type 16 bits) ` wchar_t`.

Voir également isNull() et isEmpty().

[noexcept] QStringView::QStringView(const QString &str)

Crée une vue de chaîne sur str.

str.data() doit rester valide pendant toute la durée de vie de cet objet de vue de chaîne.

La vue de chaîne sera nulle si et seulement si str.isNull().

[constexpr noexcept] QStringView::QStringView(std::nullptr_t)

Crée une vue de chaîne vide.

Voir aussi isNull().

[constexpr] template <typename Char, QStringView::if_compatible_char<Char> = true> QStringView::QStringView(const Char *first, const Char *last)

Crée une vue de chaîne sur first avec la longueur (last - first).

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

Le fait de passer \nullptr comme first est sans risque si last est également nullptr, et donne lieu à une vue de chaîne nulle.

Le comportement est indéfini si last précède first, ou si first est nullptr et que last ne l’est pas.

Contraintes

Ne participe à la résolution des surcharges que si ` Char ` est un type de caractère compatible. Les types de caractères compatibles sont : ` QChar`, ` ushort`, ` char16_t ` et (sur les plateformes, telles que Windows, où il s'agit d'un type 16 bits) ` wchar_t`.

[constexpr] template <typename Char, QStringView::if_compatible_char<Char> = true> QStringView::QStringView(const Char *str, qsizetype len)

Crée une vue de chaîne sur str d'une longueur de len.

La plage [str,len) doit rester valide pendant toute la durée de vie de cet objet de vue de chaîne.

Le passage de ` nullptr ` comme ` str ` est sans risque si ` len ` est également égal à 0, et aboutit à une vue de chaîne nulle.

Le comportement est indéfini si ` len ` est négatif ou, lorsqu’il est positif, si ` str ` est égal à ` nullptr`.

Contraintes

Ne participe à la résolution des surcharges que si Char est un type de caractère compatible. Les types de caractères compatibles sont : QChar, ushort, char16_t et (sur les plateformes, telles que Windows, où il s’agit d’un type 16 bits) wchar_t.

template <typename... Args> QString QStringView::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 incluses), 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 noexcept] QChar QStringView::at(qsizetype n) const

Renvoie le caractère situé à la position n dans cette vue de chaîne.

Le comportement est indéfini si n est négatif ou supérieur ou égal à size().

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

[constexpr] QChar QStringView::back() const

Renvoie le dernier caractère de la vue de chaîne. Équivalent à ` last()`.

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

Voir également ` front()`, ` first()` et ` last()`.

[noexcept] QStringView::const_iterator QStringView::begin() const

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

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

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

[noexcept] QStringView::const_iterator QStringView::cbegin() const

Identique à ` begin()`.

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

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

[noexcept] QStringView::const_iterator QStringView::cend() const

Identique à ` end()`.

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

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

[constexpr noexcept] void QStringView::chop(qsizetype length)

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

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

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

[constexpr noexcept] QStringView QStringView::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(), left(), right(), chop(), truncate() et slice().

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

Si cs est défini sur Qt::CaseSensitive (valeur par défaut), la comparaison tient compte de la casse ; dans le cas contraire, elle ne tient pas compte de la casse.

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

[noexcept] int QStringView::compare(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Compare cette vue de chaîne avec la vue de chaîne 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 vaut Qt::CaseSensitive (valeur par défaut), la comparaison 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 QStringView::compare(QUtf8StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Compare cette vue de chaîne avec QUtf8StringView 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 (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>().

[noexcept, since 6.1] QStringView::const_iterator QStringView::constBegin() const

Identique à ` begin()`.

Cette fonction a été introduite dans Qt 6.1.

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

[noexcept, since 6.0] QStringView::const_pointer QStringView::constData() const

Renvoie un pointeur const vers le premier caractère de la vue de chaîne.

Cette fonction a été introduite dans Qt 6.0.

Voir également data(), begin(), end() et utf16().

[noexcept, since 6.1] QStringView::const_iterator QStringView::constEnd() const

Identique à ` end()`.

Cette fonction a été introduite dans Qt 6.1.

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

Renvoie « true » si cette vue de chaîne contient une 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 ; 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 indexOf().

[since 6.1] bool QStringView::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

Renvoie « true » si l'expression régulière « re » correspond à un endroit quelconque de cette vue de chaîne ; sinon, renvoie « false ».

Si la correspondance est réussie et que ` rmatch ` n’est pas ` nullptr`, elle écrit également les résultats de la correspondance dans l’objet ` QRegularExpressionMatch ` pointé par ` rmatch`.

Cette fonction a été introduite dans Qt 6.1.

Voir également QRegularExpression::match().

[since 6.1] qsizetype QStringView::count(const QRegularExpression &re) const

Renvoie le nombre de fois où l'expression régulière re apparaît dans la vue de chaîne.

Pour des raisons historiques, cette fonction compte les correspondances qui se chevauchent. Ce comportement diffère de celui obtenu en parcourant simplement les correspondances dans la vue de chaîne à l’aide de ` QRegularExpressionMatchIterator`.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi ` QRegularExpression::globalMatch()`.

[noexcept, since 6.0] qsizetype QStringView::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Renvoie le nombre d'occurrences du caractère ch dans la vue de chaîne.

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.

Cette fonction a été introduite dans Qt 6.0.

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

[since 6.4] qsizetype QStringView::count(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Renvoie le nombre d'occurrences (pouvant se chevaucher) de la chaîne Latin-1 analysée par l1 dans cette vue de chaîne.

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.

Cette fonction a été introduite dans Qt 6.4.

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

[noexcept, since 6.0] qsizetype QStringView::count(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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.

Cette fonction a été introduite dans Qt 6.0.

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

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

Identique à ` rbegin()`.

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

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

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

Identique à ` rend()`.

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

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

[noexcept] QStringView::const_pointer QStringView::data() const

Renvoie un pointeur const vers le premier caractère de la vue de chaîne.

Voir également begin(), end() et utf16().

[constexpr noexcept] bool QStringView::empty() const

Indique si cette vue de chaîne est vide, c'est-à-dire si size() == 0.

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

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

[noexcept] QStringView::const_iterator QStringView::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.

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

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

Renvoie true si cette vue de chaîne se termine par la chaîne UTF-16 affichée par str, la chaîne Latin-1 affichée 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 startsWith().

[constexpr] QChar QStringView::first() const

Renvoie le premier caractère de la vue de chaîne. Equivalent à ` front()`.

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

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

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

Renvoie une vue de chaîne qui pointe vers les x premiers caractères de cette vue de chaîne ( n ).

Cette fonction a été introduite dans Qt 6.0.

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

[static constexpr noexcept] template < typename Char, size_t Size, QStringView::if_compatible_char<Char> = true > QStringView QStringView::fromArray(const Char (&string)[Size])

Construit une vue de chaîne à partir du littéral de chaîne complet string composé d’ Size éléments, y compris tout caractère de fin Char(0). Si vous ne souhaitez pas que le caractère de fin soit inclus dans la vue, vous pouvez le supprimer à l’aide de chop() lorsque vous êtes certain qu’il se trouve à la fin. Vous pouvez également utiliser la surcharge du constructeur prenant un littéral de tableau, qui créera une vue s'étendant jusqu'au premier caractère de fin de chaîne (à l'exclusion de celui-ci) présent dans les données.

string doit rester valide pendant toute la durée de vie de cet objet « view » de chaîne.

Cette fonction fonctionne avec n’importe quel littéral de tableau si Char est un type de caractère compatible. Les types de caractères compatibles sont : QChar, ushort, char16_t et (sur les plateformes telles que Windows, où il s’agit d’un type 16 bits) wchar_t.

[constexpr] QChar QStringView::front() const

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

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

Voir aussi back(), first() et last().

Renvoie la position d’index 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, dans cette vue de chaîne, en effectuant une recherche vers l’avant à partir de la position d’index from. Renvoie -1 si str, l1 ou ch n’est pas trouvé, respectivement.

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

Voir aussi QString::indexOf().

[since 6.1] qsizetype QStringView::indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const

Renvoie l'index de la première occurrence de l'expression régulière re dans la vue de chaîne, en effectuant une recherche vers l'avant à partir de l'index from. Renvoie -1 si re n'a été trouvé nulle part.

Si la correspondance aboutit et que rmatch n’est pas nullptr, elle écrit également les résultats de la correspondance dans l’objet QRegularExpressionMatch pointé par rmatch.

Cette fonction a été introduite dans Qt 6.1.

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

Renvoie si cette vue de chaîne est vide, c'est-à-dire si ` size() == 0`.

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

Voir également empty(), isNull(), size() et length().

[noexcept, since 6.7] bool QStringView::isLower() const

Renvoie « true » si cette vue est identique à sa version en minuscules.

Notez que cela ne signifie pas que la vue de chaîne ne contient pas de lettres majuscules (certaines lettres majuscules n’ont pas de forme minuscule correspondante ; elles restent inchangées par la fonction toString().toLower()). Pour plus d’informations, reportez-vous à la norme Unicode, section 3.13.

Cette fonction a été introduite dans Qt 6.7.

Voir également QChar::toLower() et isUpper().

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

Renvoie si cette vue de chaîne est nulle, c'est-à-dire si ` data() == nullptr`.

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

Voir également empty(), isEmpty(), size() et length().

[noexcept] bool QStringView::isRightToLeft() const

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

Voir aussi QString::isRightToLeft().

[noexcept, since 6.7] bool QStringView::isUpper() const

Renvoie « true » si cette vue est identique à sa version en majuscules.

Notez que cela ne signifie pas que la vue de chaîne ne contient pas de lettres minuscules (certaines lettres minuscules n’ont pas de forme majuscule correspondante ; elles restent inchangées par la fonction toString().toUpper()). Pour plus d’informations, reportez-vous à la norme Unicode, section 3.13.

Cette fonction a été introduite dans Qt 6.7.

Voir également ` QChar::toUpper()` et ` isLower()`.

[noexcept] bool QStringView::isValidUtf16() const

Renvoie « true » si la vue de chaîne contient des données encodées en UTF-16 valides, ou « false » dans le cas contraire.

Notez que cette fonction n'effectue aucune validation particulière des données ; elle vérifie simplement si celles-ci peuvent être décodées correctement à partir du format UTF-16. Les données sont supposées être dans l'ordre des octets de l'hôte ; la présence d'un BOM n'a aucune signification.

Voir également QString::isValidUtf16().

[constexpr] QChar QStringView::last() const

Renvoie le dernier caractère de la vue de chaîne. Équivalent à la fonction ` back()`.

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

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

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

Renvoie une vue de chaîne qui pointe vers les derniers n caractères de cette vue de chaîne.

Cette fonction a été introduite dans Qt 6.0.

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

[since 6.2] qsizetype QStringView::lastIndexOf(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

Renvoie l'index de la dernière occurrence de l'expression régulière re dans la vue de chaîne. Renvoie -1 si re n'a été trouvé nulle part.

Si la correspondance est réussie et que rmatch n’est pas nullptr, elle écrit également les résultats de la correspondance dans l’objet QRegularExpressionMatch pointé par rmatch.

Cette fonction a été introduite dans Qt 6.2.

Renvoie la position d'index 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, dans cette vue de chaîne, en effectuant une recherche vers l'arrière à partir de la position d'index from.

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.

Renvoie -1 si str, l1 ou ch n’est pas trouvé, respectivement.

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 QString::lastIndexOf().

[since 6.1] qsizetype QStringView::lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const

Renvoie la position d'index de la dernière occurrence de l'expression régulière re dans la vue de chaîne, qui commence avant la position d'index from.

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.

Renvoie -1 si re n’a donné aucun résultat.

Si la correspondance est réussie et que rmatch n’est pas nullptr, elle écrit également les résultats de la correspondance dans l’objet QRegularExpressionMatch pointé par rmatch.

Cette fonction a été introduite dans Qt 6.1.

[noexcept, since 6.3] qsizetype QStringView::lastIndexOf(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Cette fonction a été introduite dans Qt 6.3.

Renvoie l'index de la dernière occurrence de la chaîne UTF-16 traitée par str ou de la chaîne Latin-1 traitée par l1, respectivement, dans cette vue de chaîne, en effectuant une recherche vers l'arrière à partir du dernier caractère de cette vue de chaîne. Renvoie -1 si str ou l1 n'est pas trouvé, respectivement.

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.

Ces fonctions ont été introduites dans Qt 6.2.

Voir également QString::lastIndexOf().

[constexpr noexcept] qsizetype QStringView::length() const

Identique à ` size()`.

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

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

[since 6.4] int QStringView::localeAwareCompare(QStringView other) const

Compare cette vue de chaîne avec la vue de chaîne other et renvoie un entier inférieur, égal ou supérieur à zéro si cette vue de chaîne est inférieure, égale ou supérieure à la vue de chaîne other.

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.

Cette fonction a été introduite dans Qt 6.4.

Voir également Comparing Strings.

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

Elle renvoie le nombre maximal d'éléments que la vue 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 QStringView::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.

[noexcept] QStringView::const_reverse_iterator QStringView::rbegin() const

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

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

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

[noexcept] QStringView::const_reverse_iterator QStringView::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 vue de chaîne, dans l'ordre inverse.

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

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

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

Renvoie la taille de cette vue de chaîne, en unités de code UTF-16 (c'est-à-dire que les paires de substituts comptent pour deux dans le cadre de cette fonction, comme dans QString).

Voir également empty(), isEmpty(), isNull() et length().

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

Modifie cette vue de chaîne pour qu'elle commence à la position pos et s'étende sur n points de code.

Cette fonction a été introduite dans Qt 6.8.

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

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

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

Cette fonction a été introduite dans Qt 6.8.

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

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

Renvoie une vue de chaîne 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 également first(), last(), chopped(), chop(), truncate() et slice().

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

Renvoie une vue de chaîne commençant à la position pos dans cet objet et s'étendant jusqu'à la fin de celui-ci.

Cette fonction a été introduite dans Qt 6.0.

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

Divise la vue en sous-vues de chaînes de caractères à chaque occurrence de « sep » et renvoie la liste de ces sous-vues.

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

Ces fonctions ont été introduites dans Qt 6.0.

[since 6.0] QList<QStringView> QStringView::split(const QRegularExpression &re, Qt::SplitBehavior behavior = Qt::KeepEmptyParts) const

Divise la chaîne en sous-chaînes partout où l'expression régulière re correspond, et renvoie la liste de ces chaînes. Si re ne correspond à aucun endroit de la chaîne, split() renvoie une liste à un seul élément contenant cette chaîne en tant que sous-chaîne.

Cette fonction a été introduite dans Qt 6.0.

Renvoie « true » si cette vue de chaîne commence par la chaîne UTF-16 représentée par « str », la chaîne Latin-1 représentée 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().

[since 6.0] CFStringRef QStringView::toCFString() const

Crée un objet CFString à partir de cette chaîne « QStringView ».

L'appelant est propriétaire du CFString et est chargé de le libérer.

Cette fonction a été introduite dans Qt 6.0.

[since 6.0] double QStringView::toDouble(bool *ok = nullptr) const

Renvoie la vue de chaîne convertie en une valeur de type « double ».

Renvoie l'infini si la conversion entraîne 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().

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toDouble().

[since 6.0] float QStringView::toFloat(bool *ok = nullptr) const

Renvoie la vue de chaîne convertie en une valeur de type « float ».

Renvoie l'infini si la conversion entraîne 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 la locale « C ». Pour une conversion dépendante de la locale, utilisez QLocale::toFloat()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toFloat().

[since 6.0] int QStringView::toInt(bool *ok = nullptr, int base = 10) const

Renvoie la vue de chaîne convertie en un « int » 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 ; sinon, si la chaîne commence par « 0 », la base 8 est utilisée ; dans les autres cas, 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épendante des paramètres régionaux, utilisez QLocale::toInt()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toInt().

QByteArray QStringView::toLatin1() const

Renvoie une représentation Latin-1 de la chaîne sous la forme d'un objet ` QByteArray`.

Le comportement est indéfini si la chaîne contient des caractères non Latin-1.

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

QByteArray QStringView::toLocal8Bit() const

Renvoie une représentation locale sur 8 bits de la chaîne sous la forme d'un ` QByteArray`.

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.

Le comportement est indéfini si la chaîne contient des caractères non pris en charge par l’encodage 8 bits de la locale.

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

[since 6.0] long QStringView::toLong(bool *ok = nullptr, int base = 10) const

Renvoie la vue de chaîne convertie en un « 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`, un échec est signalé en définissant *`ok ` sur ` false`, et une 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 ; sinon, 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épendant des paramètres régionaux, utilisez QLocale::toLong()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toLong().

[since 6.0] qlonglong QStringView::toLongLong(bool *ok = nullptr, int base = 10) const

Renvoie la vue de chaîne convertie en un « long long » en utilisant la valeur de 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 ; sinon, si la chaîne commence par « 0 », la base 8 est utilisée ; dans le cas contraire, 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épendante des paramètres régionaux, utilisez QLocale::toLongLong()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toLongLong().

[since 6.0] NSString *QStringView::toNSString() const

Crée un NSString à partir de cet objet « QStringView ».

Le NSString est libéré automatiquement.

Cette fonction a été introduite dans Qt 6.0.

[since 6.0] short QStringView::toShort(bool *ok = nullptr, int base = 10) const

Renvoie la vue de chaîne convertie en un « short » 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 ; sinon, si la chaîne commence par « 0 », la base 8 est utilisée ; dans le cas contraire, 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épendante des paramètres régionaux, utilisez QLocale::toShort()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toShort().

QString QStringView::toString() const

Renvoie une copie profonde des données de cette vue de chaîne sous la forme d'un objet ` QString`.

La valeur renvoyée sera l'QString e null si et seulement si cette vue de chaîne est nulle.

[since 6.0] uint QStringView::toUInt(bool *ok = nullptr, int base = 10) const

Renvoie la vue de 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 é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 ; sinon, si la chaîne commence par « 0 », la base 8 est utilisée ; dans le cas contraire, 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épendante des paramètres régionaux, utilisez QLocale::toUInt()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toUInt().

[since 6.0] ulong QStringView::toULong(bool *ok = nullptr, int base = 10) const

Renvoie la vue de chaîne convertie en une chaîne de type « unsigned 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 ; sinon, si la chaîne commence par « 0 », la base 8 est utilisée ; dans le cas contraire, 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épendante des paramètres régionaux, utilisez QLocale::toULongLong()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toULong().

[since 6.0] qulonglong QStringView::toULongLong(bool *ok = nullptr, int base = 10) const

Renvoie la vue de chaîne convertie en un « 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 ; sinon, si la chaîne commence par « 0 », la base 8 est utilisée ; dans le cas contraire, 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épendante des paramètres régionaux, utilisez QLocale::toULongLong()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toULongLong().

[since 6.0] ushort QStringView::toUShort(bool *ok = nullptr, int base = 10) const

Renvoie la vue de chaîne convertie en un « unsigned short » 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 ; sinon, si la chaîne commence par « 0 », la base 8 est utilisée ; dans le cas contraire, 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épendante des paramètres régionaux, utilisez QLocale::toUShort()

Cette fonction a été introduite dans Qt 6.0.

Voir également QString::toUShort().

QList<uint> QStringView::toUcs4() const

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

UCS-4 est un codec Unicode et est donc sans perte. Tous les caractères de cette vue de chaîne seront encodés en UCS-4. Toute séquence invalide d’unités de code dans cette vue de 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 un 0.

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

QByteArray QStringView::toUtf8() const

Renvoie une représentation UTF-8 de la vue de chaîne sous la forme d'un objet ` 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.

qsizetype QStringView::toWCharArray(wchar_t *array) const

Transcrit cette vue de chaîne dans l'array fournie.

L'appelant doit s'assurer que ` array ` est suffisamment grand pour contenir l'encodage ` wchar_t ` de cette vue de chaîne (allouer un tableau de même longueur que la vue de chaîne est toujours suffisant). Le tableau est encodé en UTF-16 sur les plateformes où wchar_t a une largeur de 2 octets (par exemple, sous Windows) ; dans le cas contraire (systèmes Unix), wchar_t est supposé avoir une largeur de 4 octets et les données sont écrites en UCS-4.

Renvoie le nombre d’entrées de ` wchar_t ` écrites dans ` array`.

Voir également QString::toWCharArray().

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

Divise la chaîne en sous-chaînes à chaque occurrence d'sep, et 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èles de classes (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] QStringView QStringView::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 ` true`. Cela inclut les caractères ASCII « `'` »\t, « `\n` », « `\v` », « `\f` », « `\r` » et « `'` ».

[constexpr noexcept] void QStringView::truncate(qsizetype length)

Tronque cette chaîne de caractères à la longueur length.

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

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

[constexpr noexcept] const QStringView::storage_type *QStringView::utf16() const

Renvoie un pointeur const vers le premier caractère de la vue de chaîne.

storage_type char16_t.

Voir également begin(), end() et data().

[constexpr noexcept, since 6.7] QStringView::operator std::u16string_view() const

Convertit cet objet ` QStringView ` en un objet ` std::u16string_view `. La vue renvoyée aura le même pointeur de données et la même longueur que cette vue.

Cette fonction a été introduite dans Qt 6.7.

[constexpr] QChar QStringView::operator[](qsizetype n) const

Renvoie le caractère situé à la position n dans cette vue de chaîne.

Le comportement est indéfini si n est négatif ou non inférieur à size().

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