QAnyStringView Class

Documentation des fonctions membres

[constexpr noexcept] QAnyStringView::QAnyStringView()

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

Voir aussi isNull().

[constexpr noexcept] template <typename Char, QAnyStringView::if_compatible_char<Char> = true> QAnyStringView::QAnyStringView(const Char &ch)

Construit une vue de chaîne sur le caractère unique ch. La longueur est généralement 1 (mais voir ci-dessous).

En général, vous devez supposer qu'un QAnyStringView ainsi créé commencera à référencer des données périmées à la fin de l'expression complète, lorsque les temporaires sont supprimés. Cela signifie que l'utiliser pour passer un seul caractère à une fonction QAnyStringView est correct et sûr (tant que la documentation de la fonction ne demande pas une durée de vie plus longue que l'appel initial) :

int to_int(QAnyStringView);
int res = to_int(u'9'); // OK, data stays around for the duration of the call

Mais garder l'objet plus longtemps est un comportement non défini :

QAnyStringView ch = u'9';
int res = to_int(ch); // (silent) ERROR: ch references deleted data

Si vous en avez besoin, préférez

const auto nine = u'9';
QAnyStringView ch(nine); // ok, references `nine`, which outlives `ch`
int res = to_int(ch); // 9

Ce qui précède est vrai pour tous les langages directement supportés par Compatible Character Types.

Si ch n'est pas l'un de ces types, mais convertit simplement en QChar, par exemple QChar::SpecialCharacter ou QLatin1Char, le QAnyStringView se liera à un objet temporaire qui aura été supprimé à la fin de l'expression complète, comme dans le deuxième exemple.

Si ch ne peut pas être représenté dans une seule unité de code UTF-16 (par exemple parce qu'il s'agit d'une valeur char32_t ), ce constructeur décompose ch en deux unités de code UFT-16. Le QAnyStringView résultant aura un size() de 2 dans ce cas, et le tampon temporaire dans lequel la décomposition est stockée est supprimé à la fin de l'expression complète, semblable à

[](char32_t ch, auto &&tmp = QChar::fromUcs4(ch)) {
    return QAnyStringView(tmp);
}

La version sûre équivalente dans ce cas serait

const auto decomposed = QChar::fromUcs4(ch);
QAnyStringView ch(decomposed);

Voir également QChar::fromUcs4() et Compatible Character Types.

[constexpr noexcept] template <typename Char, size_t N> QAnyStringView::QAnyStringView(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

Ne participe à la résolution de surcharge que si string est un tableau réel et que Char est un type de caractère compatible.

Voir également Compatible Character Types.

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

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

str La longueur 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.

Voir aussi isNull() et Compatible Character Types.

[constexpr noexcept] template <typename Container, QAnyStringView::if_compatible_container<Container> = true> QAnyStringView::QAnyStringView(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

Ne participe à la résolution de surcharge que si Container est un conteneur avec un type de caractère compatible avec value_type.

Voir aussi isNull() et isEmpty().

[noexcept] QAnyStringView::QAnyStringView(const QByteArray &str)

Construit une vue de chaîne sur str. Les données contenues dans str sont interprétées en UTF-8.

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

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

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

Construit une vue de chaîne sur str.

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

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

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

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

Voir aussi isNull().

[constexpr] template <typename Char, QAnyStringView::if_compatible_char<Char> = true> QAnyStringView::QAnyStringView(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.

Voir aussi isNull() et Compatible Character Types.

[constexpr] template <typename Char, QAnyStringView::if_compatible_char<Char> = true> QAnyStringView::QAnyStringView(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

Ne participe à la résolution des surcharges que si Char est un type de caractère compatible.

Voir également isNull() et Compatible Character Types.

[since 6.9] template <typename... Args> QString QAnyStringView::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] QChar QAnyStringView::back() const

Renvoie le dernier caractère de la vue de la chaîne de caractères.

Cette fonction est fournie pour la compatibilité STL.

Voir aussi front() et Sizes and Sub-Strings.

[constexpr, since 6.5] void QAnyStringView::chop(qsizetype n)

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

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

Cette fonction a été introduite dans Qt 6.5.

Voir aussi sliced(), first(), last(), chopped(), truncate(), slice(), et Sizes and Sub-Strings.

[constexpr, since 6.5] QAnyStringView QAnyStringView::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).

Cette fonction a été introduite dans Qt 6.5.

Voir aussi sliced(), first(), last(), chop(), truncate(), slice() et Sizes and Sub-Strings.

[static noexcept] int QAnyStringView::compare(QAnyStringView lhs, QAnyStringView rhs, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Compare la vue de chaîne lhs avec la vue de chaîne rhs et renvoie un nombre entier négatif si lhs est inférieur à rhs, un nombre entier positif s'il est supérieur à rhs, et zéro s'ils sont égaux.

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

Voir aussi operator==(), operator<() et operator>().

[constexpr noexcept] const void *QAnyStringView::data() const

Renvoie un pointeur constant sur le premier caractère de la vue de la chaîne.

Voir aussi size_bytes().

[constexpr noexcept] bool QAnyStringView::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() et size().

[constexpr, since 6.5] QAnyStringView QAnyStringView::first(qsizetype n) const

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

Cette fonction a été introduite dans Qt 6.5.

Voir aussi last(), sliced(), chopped(), chop(), truncate(), slice() et Sizes and Sub-Strings.

[static constexpr noexcept] template < typename Char, size_t Size, QAnyStringView::if_compatible_char<Char> = true > QAnyStringView QAnyStringView::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 : QChar, ushort, char16_t et (sur les plates-formes, telles que Windows, où il s'agit d'un type 16 bits) wchar_t.

[constexpr] QChar QAnyStringView::front() const

Renvoie le premier caractère de la vue de la chaîne de caractères.

Cette fonction est fournie pour la compatibilité STL.

Voir aussi back() et Sizes and Sub-Strings.

[constexpr noexcept] bool QAnyStringView::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() et size().

[constexpr noexcept] bool QAnyStringView::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() et size().

[constexpr, since 6.5] QAnyStringView QAnyStringView::last(qsizetype n) const

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

Cette fonction a été introduite dans Qt 6.5.

Voir aussi first(), sliced(), chopped(), chop(), truncate(), slice() et Sizes and Sub-Strings.

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

Identique à size().

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

Voir aussi size().

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

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

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] qsizetype QAnyStringView::size() const

Renvoie la taille de cette vue de chaîne, en points de code de l'encodage.

Voir aussi empty(), isEmpty(), isNull(), size_bytes(), et Sizes and Sub-Strings.

[constexpr noexcept] qsizetype QAnyStringView::size_bytes() const

Renvoie la taille de cette vue de chaîne, mais en octets, pas en points de code.

Vous pouvez utiliser cette fonction avec data() pour le hachage ou la sérialisation.

Cette fonction est fournie pour la compatibilité STL.

Voir aussi size() et data().

[constexpr, since 6.8] QAnyStringView &QAnyStringView::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(), truncate(), et Sizes and Sub-Strings.

[constexpr, since 6.8] QAnyStringView &QAnyStringView::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(), truncate() et Sizes and Sub-Strings.

[constexpr, since 6.5] QAnyStringView QAnyStringView::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é.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi first(), last(), chopped(), chop(), truncate(), slice(), et Sizes and Sub-Strings.

[constexpr, since 6.5] QAnyStringView QAnyStringView::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.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi first(), last(), chopped(), chop(), truncate(), slice() et Sizes and Sub-Strings.

QString QAnyStringView::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, since 6.5] void QAnyStringView::truncate(qsizetype n)

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

Identique à *this = first(n).

Cette fonction a été introduite dans Qt 6.5.

Voir aussi sliced(), first(), last(), chopped(), chop() et Sizes and Sub-Strings.

[constexpr] template <typename Visitor> decltype(auto) QAnyStringView::visit(Visitor &&v) const

Appelle v avec QUtf8StringView, QLatin1String, ou QStringView, en fonction de l'encodage des données de la chaîne que cette vue de chaîne référence.

C'est ainsi que la plupart des fonctions utilisant QAnyStringView se transforment en fonctions par encodage :

void processImpl(QLatin1String s) { ~~~ }
void processImpl(QUtf8StringView s) { ~~~ }
void processImpl(QStringView s) { ~~~ }

void process(QAnyStringView s)
{
    s.visit([](auto s) { processImpl(s); });
}

Ici, nous réutilisons le même nom, s, à la fois pour l'objet QAnyStringView et pour le paramètre de la lambda. Il s'agit d'un code idiomatique qui permet de suivre l'identité des objets lors des appels à visit(), par exemple dans des situations plus complexes telles que les suivantes

bool equal(QAnyStringView lhs, QAnyStringView rhs)
{
    // assuming operator==(QAnyStringView, QAnyStringView) didn't, yet, exist:
    return lhs.visit([rhs](auto lhs) {
        rhs.visit([lhs](auto rhs) {
            return lhs == rhs;
        });
    });
}

visit() exige que toutes les instanciations de lambda aient le même type de retour. S'ils diffèrent, vous obtenez une erreur de compilation, même s'il existe un type commun. Pour résoudre ce problème, vous pouvez utiliser des types de retour explicites dans la lambda ou effectuer une conversion dans les instructions de retour :

// wrong:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {   // ERROR: lambdas return different types
        return input.sliced(0, input.size() / 2);
    });
}
// correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) -> QAnyStringView { // OK, explicit return type
        return input.sliced(0, input.size() / 2);
    });
}
// also correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {
        return QAnyStringView(input.sliced(0, input.size() / 2)); // OK, cast to common type
    });
}