QSpan Class

Documentation des fonctions membres

[implicit] QSpan::QSpan()

Constructeur par défaut.

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

Voir également extent et Variable-Size and Fixed-Size Spans.

Crée un objet ` QSpan ` faisant référence aux données contenues dans la balise `span` fournie other.

Contraintes

Ne participe à la résolution des surcharges que si

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

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

Crée un objet `QSpan` faisant référence aux données de la plage fournie r.

Contraintes

Ne participe à la résolution des surcharges que si ` Range ` est de type ` a compatible range`.

Crée un objet ` QSpan ` faisant référence aux données du tableau fourni ` arr`.

Contraintes

Ne participe à la résolution des surcharges que si

• soit N, soit extent est de type std::dynamic_extent ou, dans le cas contraire, extent == N
• et que soit S, soit const S, soit identique à T.

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

Crée un objet `QSpan` faisant référence aux données de la liste d'initialisation fournie il.

Contraintes

Ne participe à la résolution des surcharges que si T est qualifié par 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)

Crée un objet QSpan faisant référence aux données commençant à l'adresse first et dont la longueur est comprise entre (last et first).

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

Contraintes

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

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

Crée un objet QSpan faisant référence aux données commençant à l'adresse first et d'une longueur de count.

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

Contraintes

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

[constexpr] auto QSpan::back() const

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

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

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

Les itérateurs de QSpan n'étant que des pointeurs, cela revient à appeler data().

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

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

Renvoie un objet ` const_iterator ` pointant vers le début de la plage.

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

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

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

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

Renvoie un objet ` const_iterator ` pointant sur l'élément situé juste après la fin de la balise `span`.

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

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

Comme sur *this = chopped(,n et).

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

Cette fonction a été introduite dans Qt 6.9.

Voir également chopped().

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

Renvoie une plage « variable-sized » de taille size() - n faisant référence aux premiers éléments size() - n de cette plage.

Identique à first(size() - n).

n doit être non négatif.

Cette balise « span » 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 également subspan(), first(QSpan<T,E>::size_type), last(QSpan<T,E>::size_type) et chop().

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

Renvoie un objet ` const_reverse_iterator ` pointant vers le début de la plage inversée.

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

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

Renvoie un objet ` const_reverse_iterator ` pointant sur l'élément situé juste après la fin de la plage inversée.

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

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

Renvoie un pointeur vers le début de la plage.

Cela revient à appeler la fonction begin().

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

Renvoie si la plage est vide, c'est-à-dire si size() == 0.

Ces fonctions ont le même effet : ` empty()` est fournie pour assurer la compatibilité avec la STL et ` isEmpty()` est fournie pour assurer la compatibilité avec Qt.

Voir également ` size()` et ` size_bytes()`.

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

Renvoie un itérateur pointant sur l'élément suivant la fin de la plage.

Les itérateurs de QSpan n'étant que des pointeurs, cela revient à appeler data() + size().

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

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

Renvoie une séquence de type « fixed-sized » de taille « Count » faisant référence aux x premiers éléments de type « Count » de « *this ».

La plage 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 plage de type « variable-sized » de taille « n » faisant référence aux premiers « n » éléments de « *this ».

n doit être non négatif.

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

Voir également 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 balise `span`.

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

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

La plage 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 plage de type « variable-sized » de taille « n » faisant référence aux derniers éléments « n » de « *this ».

n doit être un nombre non négatif.

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

Voir également 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 objet ` reverse_iterator ` pointant vers le début de la plage inversée.

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

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

Renvoie un objet ` reverse_iterator ` pointant sur un élément situé juste après la fin de la plage inversée.

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

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

Renvoie la taille de la balise span, c'est-à-dire le nombre d'éléments auxquels elle fait référence.

Voir également size_bytes(), empty() et isEmpty().

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

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

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

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

Comme sur *this = sliced(,pos et).

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

Cette fonction a été introduite dans Qt 6.9.

Voir également sliced().

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

Comme sur *this = sliced(,pos,,,n,).

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

Cette fonction a été introduite dans Qt 6.9.

Voir également sliced().

Renvoie un intervalle de type « variable-sized » de taille « size() - pos » faisant référence au reste de cet intervalle après avoir supprimé les premiers éléments « pos ».

pos doit être non négatif.

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

Ces fonctions ont le même effet : ` subspan()` est fournie pour assurer la compatibilité avec la STL et ` sliced()` est fournie pour assurer la compatibilité avec Qt.

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

Renvoie une plage de type « variable-sized » de taille « n » faisant référence aux éléments « n » de cette plage, en commençant par « pos ».

pos et n doivent tous deux être non négatifs.

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

Ces fonctions ont le même effet : ` subspan()` est fournie pour la compatibilité avec la STL et ` sliced()` est fournie pour la compatibilité avec Qt.

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

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

Renvoie un « span » de taille « Count » faisant référence aux éléments « Count » de ce « span », à partir de « Offset ».

Si *this est un intervalle de taille variable, le type de retour est un intervalle de taille variable ; sinon, il s'agit d'un intervalle de taille fixe.

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

Voir également 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 un span de taille E - Offset faisant référence au reste de ce span après avoir supprimé les premiers éléments Offset.

Si *this est un span de taille variable, le type de retour est un span de taille variable ; sinon, il s’agit d’un span de taille fixe.

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

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

Ces fonctions spéciales des membres sont définies implicitement.

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

Renvoie une référence à l'élément situé à l'index idx dans la balise `span`.

L'index 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.