QSpan Class

Documentation des fonctions membres

[default] QSpan::QSpan()

Constructeur par défaut.

Ce constructeur n'est présent que si E vaut zéro (0) ou std::dynamic_extent. En d'autres termes, seules les travées de taille fixe ou variable peuvent être construites par défaut.

Voir aussi extent et Variable-Size and Fixed-Size Spans.

Construit un QSpan référençant les données dans le span fourni other.

Contraintes

Ne participe à la résolution des surcharges que si

• N ou extent sont std::dynamic_extent ou extent == N
• et si S ou const S est identique à T.

[constexpr] template <typename Range, QSpan<T, E>::if_compatible_range<Range> = true> QSpan::QSpan(Range &&r)

Construit un QSpan référençant les données de l'intervalle fourni r.

Contraintes

Ne participe à la résolution de surcharge que si Range est a compatible range.

Construit un QSpan référençant les données du tableau fourni arr.

Contraintes

Participe à la résolution de surcharge seulement si

• N ou extent sont std::dynamic_extent ou autrement extent == N
• et si S ou const S est identique à T.

[constexpr] QSpan::QSpan(std::initializer_list<QSpan<T, E>::value_type> il)

Construit un QSpan référençant les données de la liste d'initialisation fournie il.

Contraintes

Participe à la résolution des surcharges uniquement si T est qualifié pour const.

Voir également Const and Mutable Spans.

[constexpr] template <typename It, QSpan<T, E>::if_compatible_iterator<It> = true> QSpan::QSpan(It first, It last)

Construit un QSpan référençant les données commençant à first et ayant une longueur (last - first).

[first, last) doit être un intervalle valide.

Contraintes

Ne participe à la résolution des surcharges que si It est a compatible iterator.

[constexpr] template <typename It, QSpan<T, E>::if_compatible_iterator<It> = true> QSpan::QSpan(It first, qsizetype count)

Construit un QSpan référençant les données commençant à first et ayant pour longueur count.

[first, count) doit être un intervalle valide.

Contraintes

Ne participe à la résolution des surcharges que si It est a compatible iterator.

Ces Special Member Functions sont implicitement définies.

[constexpr] auto QSpan::back() const

Renvoie une référence au dernier élément de la portée.

Le span ne doit pas être vide, sinon le comportement est indéfini.

Voir aussi operator[](), front(), size(), empty() et Const and Mutable Spans.

[constexpr noexcept] auto QSpan::begin() const

Renvoie un itérateur pointant vers le début de l'étendue.

Comme les itérateurs de QSpan ne sont que des pointeurs, cela revient à appeler data().

Voir aussi end(), cbegin(), rbegin(), crbegin(), data() et Const and Mutable Spans.

[constexpr noexcept] auto QSpan::cbegin() const

Renvoie un const_iterator pointant vers le début de l'étendue.

Cela renvoie un itérateur en lecture seule même si T n'est pas const:

QSpan<int> span = ~~~;
*span.begin() = 42; // OK
*span.cbegin() = 42; // ERROR: cannot assign through a const_iterator

Voir aussi cend(), begin(), crbegin(), rbegin(), data(), et Const and Mutable Spans.

[constexpr noexcept] auto QSpan::cend() const

Renvoie un const_iterator pointant vers une date postérieure à la fin de l'intervalle.

Voir aussi cbegin(), end(), crend(), rend(), data(), size(), et Const and Mutable Spans.

[constexpr, since 6.9] void QSpan::chop(QSpan<T, E>::size_type n)

Identique à *this = chopped(n ) .

Cette fonction n'est disponible que sur variable-sized spans.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi chopped().

[constexpr, since 6.9] auto QSpan::chopped(QSpan<T, E>::size_type n) const

Renvoie une portée variable-sized de taille size() - n référençant les premiers éléments size() - n de cette portée.

Identique à first(size() - n).

n doit être non négatif.

Cette portée doit contenir au moins n éléments (E >= n et size() >= n), sinon le comportement est indéfini.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi subspan(), first(QSpan<T,E>::size_type), last(QSpan<T,E>::size_type), et chop().

[constexpr noexcept] auto QSpan::crbegin() const

Renvoie un const_reverse_iterator pointant vers le début de la portée inversée.

Voir aussi crend(), rbegin(), cbegin(), begin(), et Const and Mutable Spans.

[constexpr noexcept] auto QSpan::crend() const

Renvoie un const_reverse_iterator pointant vers une date postérieure à la fin de la portée inversée.

Voir aussi crbegin(), rend(), cend(), end(), et Const and Mutable Spans.

[constexpr noexcept] auto QSpan::data() const

Renvoie un pointeur sur le début de la portée.

C'est la même chose que d'appeler begin().

Voir aussi begin(), front(), et Const and Mutable Spans.

Renvoie si l'étendue est vide, c'est-à-dire si size() == 0.

Ces fonctions font la même chose : empty() est fourni pour la compatibilité STL et isEmpty() est fourni pour la compatibilité Qt XML.

Voir également size() et size_bytes().

[constexpr noexcept] auto QSpan::end() const

Renvoie un itérateur pointant vers un point au-delà de la fin de l'étendue.

Comme les itérateurs de QSpan ne sont que des pointeurs, cela revient à appeler data() + size().

Voir aussi begin(), cend(), rend(), crend(), data(), size() et Const and Mutable Spans.

[constexpr noexcept(...)] template <std::size_t Count> auto QSpan::first() const

Renvoie une portée fixed-sized de taille Count faisant référence aux premiers éléments Count de *this.

L'étendue doit contenir au moins Count éléments (E >= Count et size() >= Count), sinon le comportement est indéfini.

Voir également first(QSpan<T,E>::size_type), last() et subspan().

[constexpr] auto QSpan::first(QSpan<T, E>::size_type n) const

Renvoie une portée variable-sized de taille n référençant les premiers éléments n de *this.

n doit être non négatif.

L'étendue doit contenir au moins n éléments (E >= n et size() >= n), sinon le comportement est indéfini.

Voir aussi first<N>(), last(QSpan<T,E>::size_type), subspan(QSpan<T,E>::size_type), subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type), sliced() et chopped().

[constexpr] auto QSpan::front() const

Renvoie une référence au premier élément de la portée.

Le span ne doit pas être vide, sinon le comportement est indéfini.

Voir aussi operator[](), back(), size(), empty() et Const and Mutable Spans.

[constexpr noexcept(...)] template <std::size_t Count> auto QSpan::last() const

Renvoie une portée fixed-sized de taille Count faisant référence aux derniers éléments Count de *this.

L'étendue doit contenir au moins Count éléments (E >= Count et size() >= Count), sinon le comportement est indéfini.

Voir également last(QSpan<T,E>::size_type), first() et subspan().

[constexpr] auto QSpan::last(QSpan<T, E>::size_type n) const

Renvoie une portée variable-sized de taille n référençant les derniers éléments n de *this.

n doit être non négatif.

L'étendue doit contenir au moins n éléments (E >= n et size() >= n), sinon le comportement est indéfini.

Voir aussi last(), first(QSpan<T,E>::size_type), subspan(QSpan<T,E>::size_type), subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type), sliced() et chopped().

[constexpr noexcept] auto QSpan::rbegin() const

Renvoie un reverse_iterator pointant vers le début de la portée inversée.

Voir aussi rend(), crbegin(), begin(), cbegin(), et Const and Mutable Spans.

[constexpr noexcept] auto QSpan::rend() const

Renvoie un reverse_iterator pointant vers une date postérieure à la fin de la portée inversée.

Voir aussi rbegin(), crend(), end(), cend(), et Const and Mutable Spans.

[constexpr noexcept] auto QSpan::size() const

Renvoie la taille de l'étendue, c'est-à-dire le nombre d'éléments qu'elle référence.

Voir aussi size_bytes(), empty() et isEmpty().

[constexpr noexcept] auto QSpan::size_bytes() const

Renvoie la taille de l'étendue en octets, c'est-à-dire le nombre d'éléments multiplié par sizeof(T).

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

[constexpr, since 6.9] void QSpan::slice(QSpan<T, E>::size_type pos)

Identique à *this = sliced(pos ) .

Cette fonction n'est disponible que sur variable-sized spans.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi sliced().

[constexpr, since 6.9] void QSpan::slice(QSpan<T, E>::size_type pos, QSpan<T, E>::size_type n)

Identique à *this = sliced(pos , n ) .

Cette fonction n'est disponible que sur variable-sized spans.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi sliced().

[constexpr noexcept(...)] template <std::size_t Offset, std::size_t Count> auto QSpan::subspan() const

Renvoie une portée de taille Count référençant les éléments Count de cette portée à partir de Offset.

Si *this est une étendue de taille variable, le type de retour est une étendue de taille variable, sinon il s'agit d'une étendue de taille fixe.

Cette portée doit contenir au moins Offset + Count éléments (E >= Offset + Count et size() >= Offset + Count), sinon le comportement est indéfini.

Voir aussi subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type), first(), last() et Variable-Size and Fixed-Size Spans.

[constexpr noexcept(...)] template <std::size_t Offset> auto QSpan::subspan() const

Renvoie une portée de taille E - Offset référençant le reste de cette portée après avoir supprimé les premiers éléments Offset.

Si *this est une étendue de taille variable, le type de retour est une étendue de taille variable, sinon il s'agit d'une étendue de taille fixe.

Cette portée doit contenir au moins Offset éléments (E >= Offset et size() >= Offset), sinon le comportement est indéfini.

Voir aussi subspan(QSpan<T,E>::size_type), subspan(), first(), last() et Variable-Size and Fixed-Size Spans.

Renvoie une étendue variable-sized de taille size() - pos référençant le reste de cette étendue après avoir supprimé les premiers éléments pos.

pos doit être non négatif.

Cette étendue doit contenir au moins pos éléments (E >= pos et size() >= pos), sinon le comportement est indéfini.

Ces fonctions font la même chose : subspan() est fourni pour la compatibilité STL et sliced() est fourni pour la compatibilité Qt XML.

Voir aussi subspan(), first(QSpan<T,E>::size_type), last(QSpan<T,E>::size_type), chopped() et slice().

Renvoie une étendue variable-sized de taille n référençant les éléments n de cette étendue à partir de pos.

pos et n doivent être non négatifs.

Cette portée doit contenir au moins pos + n éléments (E >= pos + n et size() >= pos + n), sinon le comportement est indéfini.

Ces fonctions font la même chose : subspan() est fourni pour la compatibilité STL et sliced() est fourni pour la compatibilité Qt XML.

Voir aussi subspan(), first(QSpan<T,E>::size_type), last(QSpan<T,E>::size_type), chopped() et slice().

[constexpr] QSpan<T, E>::reference QSpan::operator[](QSpan<T, E>::size_type idx) const

Renvoie une référence à l'élément à l'index idx dans la portée.

L'indice doit être compris dans l'intervalle, c'est-à-dire que idx >= 0 et idx < size(), sinon le comportement est indéfini.

Voir également front(), back(), size(), empty() et Const and Mutable Spans.