QSpan Class

Dokumentation der Mitgliedsfunktionen

Diese speziellen Mitgliedsfunktionen sind implizit definiert.

Konstruiert eine QSpan, die auf die Daten in dem übergebenen Array arr verweist.

• entweder N oder extent sind std::dynamic_extent oder andernfalls extent == N
• und entweder S oder const S dasselbe sind wie T.

Konstruiert eine QSpan, die auf die Daten in der übergebenen Spanne other verweist.

• entweder N oder extent sind std::dynamic_extent oder extent == N
• und entweder S oder const S das gleiche wie T sind.

Gibt zurück, ob die Spanne leer ist, d.h. ob size() == 0.

Diese Funktionen tun dasselbe: empty() ist für STL-Kompatibilität und isEmpty() für Qt-Kompatibilität vorgesehen.

Siehe auch size() und size_bytes().

Gibt eine variable-sized Spanne der Größe size() - pos zurück, die auf den Rest dieser Spanne verweist, nachdem die ersten pos Elemente weggelassen wurden.

pos muss nicht-negativ sein.

Diese Spanne muss mindestens pos Elemente enthalten (E >= pos und size() >= pos), ansonsten ist das Verhalten undefiniert.

Diese Funktionen bewirken dasselbe: subspan() ist für STL-Kompatibilität und sliced() für Qt-Kompatibilität vorgesehen.

Siehe auch subspan(), first(QSpan<T,E>::size_type), und last(QSpan<T,E>::size_type).

Gibt eine variable-sized Spanne der Größe n zurück, die die n Elemente dieser Spanne ab pos referenziert.

Sowohl pos als auch n müssen nicht-negativ sein.

Diese Spanne muss mindestens pos + n Elemente enthalten (E >= pos + n und size() >= pos + n), ansonsten ist das Verhalten undefiniert.

Diese Funktionen bewirken dasselbe: subspan() ist für STL-Kompatibilität und sliced() für Qt-Kompatibilität vorgesehen.

Siehe auch subspan(), first(QSpan<T,E>::size_type), und last(QSpan<T,E>::size_type).

[default] QSpan::QSpan()

Standard-Konstruktor.

Dieser Konstruktor ist nur vorhanden, wenn E entweder Null (0) oder std::dynamic_extent ist. Mit anderen Worten: nur Spannen mit fester oder variabler Größe sind standardmäßig konstruierbar.

Siehe auch extent und Variable-Size and Fixed-Size Spans.

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

Konstruiert einen QSpan, der auf die Daten im übergebenen Bereich r verweist.

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

Konstruiert eine QSpan, die auf die Daten in der übergebenen Initialisierungsliste il verweist.

Siehe auch Const and Mutable Spans.

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

Konstruiert einen QSpan, der die Daten ab first referenziert und die Länge (last - first) hat.

[first, last) muss ein gültiger Bereich sein.

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

Konstruiert einen QSpan, der die Daten referenziert, die bei first beginnen und die Länge count haben.

[first, count) muss ein gültiger Bereich sein.

[constexpr] auto QSpan::back() const

Gibt einen Verweis auf das letzte Element in der Spanne zurück.

Die Spanne darf nicht leer sein, sonst ist das Verhalten undefiniert.

Siehe auch operator[](), front(), size(), empty(), und Const and Mutable Spans.

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

Gibt einen Interator zurück, der auf den Anfang der Spanne zeigt.

Da QSpan Iteratoren nur Zeiger sind, ist dies dasselbe wie der Aufruf von data().

Siehe auch end(), cbegin(), rbegin(), crbegin(), data(), und Const and Mutable Spans.

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

Gibt eine const_iterator zurück, die auf den Anfang der Spanne zeigt.

Es wird ein schreibgeschützter Iterator zurückgegeben, auch wenn T nicht const ist:

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

Siehe auch cend(), begin(), crbegin(), rbegin(), data(), und Const and Mutable Spans.

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

Gibt ein const_iterator zurück, das auf eine Stelle hinter dem Ende der Spanne zeigt.

Siehe auch cbegin(), end(), crend(), rend(), data(), size(), und Const and Mutable Spans.

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

Gibt ein const_reverse_iterator zurück, das auf den Anfang der umgekehrten Spanne zeigt.

Siehe auch crend(), rbegin(), cbegin(), begin(), und Const and Mutable Spans.

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

Gibt ein const_reverse_iterator zurück, das auf eine Stelle hinter dem Ende der umgekehrten Spanne zeigt.

Siehe auch crbegin(), rend(), cend(), end(), und Const and Mutable Spans.

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

Gibt einen Zeiger auf den Anfang der Spanne zurück.

Entspricht dem Aufruf von begin().

Siehe auch begin(), front(), und Const and Mutable Spans.

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

Gibt einen Iterator zurück, der auf einen Punkt hinter dem Ende der Spanne zeigt.

Da QSpan Iteratoren nur Zeiger sind, ist dies dasselbe wie der Aufruf von data() + size().

Siehe auch begin(), cend(), rend(), crend(), data(), size(), und Const and Mutable Spans.

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

Gibt eine fixed-sized -Spanne der Größe Count zurück, die auf die ersten Count -Elemente von *this verweist.

Der Bereich muss mindestens Count Elemente enthalten (E >= Count und size() >= Count), ansonsten ist das Verhalten undefiniert.

Siehe auch first(QSpan<T,E>::size_type), last(), und subspan().

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

Gibt eine variable-sized -Spanne der Größe n zurück, die auf die ersten n -Elemente von *this verweist.

n muss nicht-negativ sein.

Die Spanne muss mindestens n Elemente enthalten (E >= n und size() >= n), ansonsten ist das Verhalten undefiniert.

Siehe auch 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), und sliced().

[constexpr] auto QSpan::front() const

Gibt einen Verweis auf das erste Element in der Spanne zurück.

Der span darf nicht leer sein, sonst ist das Verhalten undefiniert.

Siehe auch operator[](), back(), size(), empty(), und Const and Mutable Spans.

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

Gibt eine fixed-sized -Spanne der Größe Count zurück, die auf die letzten Count -Elemente von *this verweist.

Die Spanne muss mindestens Count Elemente enthalten (E >= Count und size() >= Count), ansonsten ist das Verhalten undefiniert.

Siehe auch last(QSpan<T,E>::size_type), first(), und subspan().

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

Gibt eine variable-sized -Spanne der Größe n zurück, die auf die letzten n -Elemente von *this verweist.

n muss nicht-negativ sein.

Die Spanne muss mindestens n Elemente enthalten (E >= n und size() >= n), ansonsten ist das Verhalten undefiniert.

Siehe auch last(), first(QSpan<T,E>::size_type), subspan(QSpan<T,E>::size_type), subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type), und sliced().

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

Gibt ein reverse_iterator zurück, das auf den Anfang der umgekehrten Spanne zeigt.

Siehe auch rend(), crbegin(), begin(), cbegin(), und Const and Mutable Spans.

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

Gibt ein reverse_iterator zurück, das auf eine Stelle hinter dem Ende der umgekehrten Spanne zeigt.

Siehe auch rbegin(), crend(), end(), cend(), und Const and Mutable Spans.

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

Gibt die Größe des Bereichs zurück, d. h. die Anzahl der Elemente, auf die er verweist.

Siehe auch size_bytes(), empty(), und isEmpty().

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

Gibt die Größe des Bereichs in Bytes zurück, d. h. die Anzahl der Elemente multipliziert mit sizeof(T).

Siehe auch size(), empty(), und isEmpty().

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

Gibt einen Bereich der Größe Count zurück, der die Count Elemente dieses Bereichs ab Offset referenziert.

Wenn *this ein Bereich variabler Größe ist, ist der Rückgabetyp ein Bereich variabler Größe, andernfalls ist es ein Bereich fester Größe.

Dieser Bereich muss mindestens Offset + Count Elemente enthalten (E >= Offset + Count und size() >= Offset + Count), ansonsten ist das Verhalten undefiniert.

Siehe auch subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type), subspan(), first(), last(), und Variable-Size and Fixed-Size Spans.

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

Gibt einen Bereich der Größe E - Offset zurück, der auf den Rest dieses Bereichs nach Weglassen der ersten Offset Elemente verweist.

Wenn *this ein Bereich variabler Größe ist, ist der Rückgabetyp ein Bereich variabler Größe, andernfalls ist es ein Bereich fester Größe.

Dieser Bereich muss mindestens Offset Elemente enthalten (E >= Offset und size() >= Offset), ansonsten ist das Verhalten undefiniert.

Siehe auch subspan(QSpan<T,E>::size_type), subspan(), first(), last(), und Variable-Size and Fixed-Size Spans.

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

Gibt einen Verweis auf das Element am Index idx in der Spanne zurück.

Der Index muss im Bereich liegen, d. h. idx >= 0 und idx < size(), andernfalls ist das Verhalten undefiniert.

Siehe auch front(), back(), size(), empty(), und Const and Mutable Spans.