QUtf8StringView Class

    void myfun1(QUtf8StringView sv);        // preferred
    void myfun2(const QUtf8StringView &sv); // compiles and works, but slower

Documentation sur les fonctions membres

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

Construit une vue de chaîne de caractères nulle.

Voir aussi isNull().

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

Construit une vue de chaîne sur le littéral de chaîne de caractères string. La vue couvre le tableau jusqu'à ce que le premier Char(0) soit rencontré, ou jusqu'à N, selon ce qui arrive en premier. 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

Participe à la résolution des surcharges uniquement si string est un tableau réel et si Char est un type de caractère compatible. Les types de caractères compatibles sont les suivants : char8_t, char, signed char et unsigned char.

Voir également fromArray().

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

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

str doit rester valide pendant toute la durée de vie de cet objet "string view".

Transmettre nullptr en tant que str est sans danger et produit une vue de chaîne nulle.

Contraintes

Participe à la résolution des surcharges uniquement si str n'est pas un tableau et si Char est un type de caractère compatible. Les types de caractères compatibles sont : char8_t, char, signed char et unsigned char.

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

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

std::data(str) doit rester valide pendant toute la durée de vie de cet objet "string view".

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

Contraintes

Participe à la résolution de surcharge uniquement si Container est un conteneur avec un type de caractère compatible avec value_type. Les types de caractères compatibles sont : char8_t, char, signed char et unsigned char.

Voir également isNull() et isEmpty().

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

Construit une vue de chaîne de caractères nulle.

Voir aussi isNull().

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

Construit 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 "string view".

Transmettre \nullptr en tant que first est sûr si last est aussi nullptr, et résulte en une vue de chaîne nulle.

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

Contraintes

Participe à la résolution des surcharges uniquement si Char est un type de caractère compatible. Les types de caractères compatibles sont : char8_t, char, signed char et unsigned char.

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

Construit une vue de chaîne sur str avec la longueur len.

La plage [str,len) doit rester valide pendant toute la durée de vie de cet objet "string view".

Transmettre nullptr en tant que str est sûr si len est également 0, et résulte en une vue de chaîne nulle.

Le comportement est indéfini si len est négatif ou, lorsqu'il est positif, si str est nullptr.

Contraintes

Participe à la résolution des surcharges uniquement si Char est un type de caractère compatible. Les types de caractères compatibles sont les suivants : char8_t, char, signed char et unsigned char.

[since 6.9] template <typename... Args> QString QUtf8StringView::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.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi QString::arg(Args&&...).

[constexpr] QUtf8StringView::storage_type QUtf8StringView::at(qsizetype n) const

Renvoie le point de code à la position n dans cette vue de chaîne de caractères.

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

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

[constexpr] QUtf8StringView::storage_type QUtf8StringView::back() const

Renvoie le dernier point de code dans la vue de la chaîne. Identique à last().

Cette fonction est fournie pour la compatibilité STL.

Voir également front().

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

Renvoie un itérateur constant de style STL pointant vers le premier point de code dans la vue de la chaîne.

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

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

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

Identique à begin().

Cette fonction est fournie pour la compatibilité STL.

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

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

Identique à end().

Cette fonction est fournie pour la compatibilité STL.

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

[constexpr] void QUtf8StringView::chop(qsizetype n)

Tronque cette vue de la chaîne de caractères par n points de code.

Identique à *this = first(size() - n).

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

[constexpr] QUtf8StringView QUtf8StringView::chopped(qsizetype n) const

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

Identique à first(size() - n).

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

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.

Ces fonctions ont été introduites dans Qt 6.5.

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

Identique à rbegin().

Cette fonction est fournie pour la compatibilité STL.

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

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

Identique à rend().

Cette fonction est fournie pour la compatibilité STL.

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

[constexpr noexcept] QUtf8StringView::const_pointer QUtf8StringView::data() const

Renvoie un pointeur constant sur le premier point de code de la vue de la chaîne.

Voir aussi begin(), end() et utf8().

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

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

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

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

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::end() const

Renvoie un itérateur de style STL constant pointant vers le point de code imaginaire situé après le dernier point de code de la liste.

Cette fonction est fournie pour la compatibilité STL.

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

[constexpr] QUtf8StringView QUtf8StringView::first(qsizetype n) const

Renvoie une vue de chaîne qui contient les premiers n points de code de cette vue de chaîne.

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

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

Construit une vue de chaîne sur le littéral de chaîne de caractères complet string, y compris toute fin de chaîne Char(0). Si vous ne voulez pas que le terminateur null soit inclus dans la vue, vous pouvez chop() l'enlever lorsque vous êtes certain qu'il se trouve à la fin. Vous pouvez également utiliser la surcharge du constructeur en prenant un littéral de tableau qui créera une vue jusqu'au premier terminateur nul dans les données, mais sans l'inclure.

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

Cette fonction fonctionnera avec n'importe quel littéral de tableau si Char est un type de caractère compatible. Les types de caractères compatibles sont les suivants : char8_t, char, signed char et unsigned char.

[constexpr] QUtf8StringView::storage_type QUtf8StringView::front() const

Renvoie le premier point de code dans la vue de la chaîne. Identique à first().

Cette fonction est fournie pour la compatibilité STL.

Voir également back().

[constexpr noexcept] bool QUtf8StringView::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 aussi empty(), isNull(), size() et length().

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

Retourne 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 aussi empty(), isEmpty(), size() et length().

[noexcept, since 6.3] bool QUtf8StringView::isValidUtf8() const

Renvoie true si cette chaîne contient des données encodées UTF-8 valides, ou false dans le cas contraire.

Cette fonction a été introduite dans Qt 6.3.

[constexpr] QUtf8StringView QUtf8StringView::last(qsizetype n) const

Renvoie une vue de chaîne qui contient les derniers n points de code de cette vue de chaîne.

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

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

Identique à size().

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

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

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

Il renvoie le nombre maximum d'éléments que la vue 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 QUtf8StringView::max_size() const

Cette fonction est fournie pour la compatibilité STL.

Retourne maxSize().

Cette fonction a été introduite dans Qt 6.8.

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

Renvoie un itérateur inverse de style STL pointant vers le premier point de code dans la vue de la chaîne, dans l'ordre inverse.

Cette fonction est fournie pour la compatibilité STL.

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

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

Renvoie un itérateur inverse de style STL pointant vers un point de code après le dernier dans la vue de la chaîne, dans l'ordre inverse.

Cette fonction est fournie pour la compatibilité STL.

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

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

Renvoie la taille de cette vue de chaîne, en points de code UTF-8 (c'est-à-dire que les séquences de plusieurs octets comptent pour plus d'un dans le cadre de cette fonction, comme les paires de substituts dans QString et QStringView).

Voir aussi empty(), isEmpty(), isNull() et length().

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

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

Cette fonction a été introduite dans Qt 6.8.

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

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

Modifie cette vue de chaîne 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] QUtf8StringView QUtf8StringView::sliced(qsizetype pos) const

Renvoie une vue de chaîne de caractères commençant à la position pos dans cet objet et s'étendant jusqu'à son extrémité.

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

[constexpr] QUtf8StringView QUtf8StringView::sliced(qsizetype pos, qsizetype n) const

Renvoie une vue de chaîne contenant n points de code de cette vue de chaîne, commençant à la position pos.

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

QString QUtf8StringView::toString() const

Renvoie une copie profonde des données de cette vue de chaîne sous forme de QString.

La valeur de retour sera un null QString si et seulement si cette vue de chaîne est null.

[constexpr] void QUtf8StringView::truncate(qsizetype n)

Tronque cette vue de la chaîne à n points de code.

Identique à *this = first(n).

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

[noexcept] const char8_t *QUtf8StringView::utf8() const

Renvoie un pointeur constant sur le premier point de code de la vue de la chaîne.

Le résultat est renvoyé sous la forme d'un const char8_t*, de sorte que cette fonction n'est disponible que lors de la compilation en mode C++20.

Voir aussi begin(), end() et data().

[noexcept, since 6.7] QUtf8StringView::operator std::string_view() const

Convertit cet objet QUtf8StringView en un objet std::string_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.

[noexcept, since 6.10] QUtf8StringView::operator std::u8string_view() const

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

Cette fonction n'est disponible que lors de la compilation en mode C++20.

Cette fonction a été introduite dans Qt 6.10.

[constexpr] QUtf8StringView::storage_type QUtf8StringView::operator[](qsizetype n) const

Renvoie le point de code à la position n dans cette vue de chaîne de caractères.

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

Voir aussi at(), front() et back().