QAnyStringView Class

Documentation des fonctions membres

[constexpr noexcept] QAnyStringView::QAnyStringView()

Crée une vue de chaîne vide.

Voir aussi isNull().

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

Crée une vue de chaîne à partir de l'ch, qui ne contient qu'un seul caractère. La longueur est généralement de 1 (mais voir ci-dessous).

En général, vous devez partir du principe qu’un QAnyStringView ainsi créé commencera à référencer des données obsolètes à la fin de l’expression complète, lorsque les variables temporaires seront supprimées. Cela signifie qu’il est possible et sans risque de l’utiliser pour transmettre un caractère unique à une fonction acceptant un QAnyStringView (à condition que la documentation de la fonction n’exige pas une durée de vie supérieure à celle de l’appel initial) :

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

En revanche, conserver l’objet plus longtemps entraîne un comportement indé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 s’applique à tous les types directement pris en charge Compatible Character Types.

Si ` ch ` n’appartient pas à l’un de ces types, mais se 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, tout comme dans le deuxième exemple.

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

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

La version sécurisée é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 (&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 ce qui survient 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 des surcharges que si string est un véritable tableau et si Char est un type de caractère compatible.

Voir également Compatible Character Types.

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

Crée une vue de chaîne sur str. La longueur est déterminée en recherchant la première occurrence de 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 en tant que str est sans risque et donne lieu à une vue de chaîne nulle.

Contraintes

Ne participe à la résolution des surcharges que si str n’est pas un tableau et si Char est un type de caractère compatible.

Voir également isNull() et Compatible Character Types.

[constexpr noexcept] template <typename Container> requires if_compatible_container<Container> QAnyStringView::QAnyStringView(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`.

Voir également isNull() et isEmpty().

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

Crée une vue de chaîne sur str. Les données contenues dans str sont interprétées au format UTF-8.

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

[noexcept] QAnyStringView::QAnyStringView(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] QAnyStringView::QAnyStringView(std::nullptr_t)

Crée une vue de chaîne vide.

Voir aussi ` isNull()`.

[constexpr] template <typename Char> requires if_compatible_char<Char> QAnyStringView::QAnyStringView(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 passage de ` 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.

Voir également isNull() et Compatible Character Types.

[constexpr] template <typename Char> requires if_compatible_char<Char> QAnyStringView::QAnyStringView(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 vaut 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 issu de args. Les arguments ne sont pas positionnels : le premier élément de args remplace %N par la valeur la plus faible de N (toutes), le deuxième élément de args remplace %N par la valeur suivante la plus faible de N, etc.

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

Cette fonction a été introduite dans Qt 6.9.

Voir également QString::arg(Args&&...).

[constexpr] QChar QAnyStringView::back() const

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

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

Voir également front() et Sizes and Sub-Strings.

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

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

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

Cette fonction a été introduite dans Qt 6.5.

Voir également 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 à partir du début de cet objet.

Identique à ` first(size() - n)`.

Cette fonction a été introduite dans Qt 6.5.

Voir également 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 chaîne « lhs » à la chaîne « rhs » et renvoie un entier négatif si « lhs » est inférieur à « rhs », un entier positif s’il est supérieur à « rhs », et zéro si les deux chaînes 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>().

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

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

Voir aussi : ` size_bytes()`.

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

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

Renvoie une vue de chaîne contenant les x n points de code de cette vue de chaîne.

Cette fonction a été introduite dans Qt 6.5.

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

[static constexpr noexcept] template <typename Char, size_t Size> requires if_compatible_char<Char> QAnyStringView QAnyStringView::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 la fonction 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 allant jusqu’au premier caractère de fin de chaîne (sans l’inclure) présent dans les données.

string doit rester valide pendant toute la durée de vie de cet objet de vue 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 QAnyStringView::front() const

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

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

Voir également 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 également empty(), isNull() et size().

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

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

Renvoie une vue de chaîne contenant les x derniers points de code de la vue de chaîne n.

Cette fonction a été introduite dans Qt 6.5.

Voir également 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 également size().

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

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

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

Cette fonction a été introduite dans Qt 6.8.

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

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

Voir également 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 et non en points de code.

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

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

Voir également 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 sur n points de code.

Cette fonction a été introduite dans Qt 6.8.

Voir également 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 de celle-ci.

Cette fonction a été introduite dans Qt 6.8.

Voir également 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 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.5.

Voir également 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 les points de code n de cette vue de chaîne, à partir de la position pos.

Cette fonction a été introduite dans Qt 6.5.

Voir également 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 la forme d'un ` QString`.

La valeur renvoyée sera une ` QString ` nulle si et seulement si cette vue de chaîne est nulle.

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

Tronque cette chaîne de caractères à n points de code.

Identique à ` *this = first(n)`.

Cette fonction a été introduite dans Qt 6.5.

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

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

Appelle la fonction ` v ` en lui passant soit ` QUtf8StringView`, soit ` QLatin1String`, soit ` QStringView`, selon l'encodage des données de chaîne auxquelles cette vue de chaîne fait référence.

C'est ainsi que la plupart des fonctions prenant QAnyStringView se ramifient en fonctions spécifiques à chaque 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 du lambda. Il s’agit d’un code idiomatique qui permet de suivre l’identité des objets à travers les appels à `visit()`, par exemple dans des situations plus complexes telles que

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. Si elles diffèrent, vous obtenez une erreur de compilation, même s'il existe un type commun. Pour y remédier, vous pouvez utiliser des types de retour explicites dans le lambda ou effectuer un transtypage 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
    });
}