QSpan Class

Dokumentation zu den Mitgliedsfunktionen

[implicit] QSpan::QSpan()

Standardkonstruktor.

Dieser Konstruktor ist nur vorhanden, wenn „ E “ entweder Null (0) oder „ std::dynamic_extent “ ist. Mit anderen Worten: Nur Spans mit fester Größe Null oder variabler Größe lassen sich mit dem Standardkonstruktor instanziieren.

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

Erstellt ein „ QSpan “, das auf die Daten in der angegebenen „span“ verweist: other.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn

• entweder „ N “ oder „ extent “ „ std::dynamic_extent “ oder „ extent “ sind == N
• und entweder S oder const S mit T übereinstimmen.

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

Erstellt ein QSpan, das auf die Daten im angegebenen Bereich r verweist.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn Range ein „ a compatible range “ ist.

Erstellt ein ` QSpan `, das auf die Daten im übergebenen Array ` arr` verweist.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn

• entweder ` N ` oder ` extent ` ` std::dynamic_extent ` sind oder andernfalls ` extent ` ` == ` N
• und entweder S oder const S mit T übereinstimmen.

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

Erstellt ein QSpan, das auf die Daten in der übergebenen Initialisierungsliste verweist: il.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn „ T “ mit „ const “ qualifiziert ist.

Siehe auch „ Const and Mutable Spans “.

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

Erstellt ein QSpan, das auf die Daten verweist, die bei first beginnen und die Länge (last – first) haben.

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

Einschränkungen

Nimmt nur dann an der Überlastauflösung teil, wenn It gleich a compatible iterator ist.

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

Erstellt ein QSpan, das auf die Daten verweist, die bei first beginnen und die Länge count haben.

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

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn It gleich a compatible iterator ist.

[constexpr] auto QSpan::back() const

Gibt eine Referenz auf das letzte Element im Bereich zurück.

Der Bereich darf nicht leer sein, andernfalls ist das Verhalten undefiniert.

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

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

Gibt einen Iterator zurück, der auf den Anfang des Bereichs zeigt.

Da Iteratoren von „ QSpan “ lediglich Zeiger sind, entspricht dies dem Aufruf von „ data()“.

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

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

Gibt einen ` const_iterator ` zurück, der auf den Anfang des Bereichs zeigt.

Dies gibt einen schreibgeschützten Iterator zurück, 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 einen ` const_iterator ` zurück, der auf eine Position direkt hinter dem Ende des Bereichs verweist.

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

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

Genau wie unter *this = chopped(,n und).

Diese Funktion ist nur unter variable-sized spans verfügbar.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch chopped().

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

Gibt einen „ variable-sized “-Span der Größe size() – n zurück, der auf die ersten size() – n Elemente dieses Spans verweist.

Entspricht first(size() - n).

n muss nicht-negativ sein.

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

Diese Funktion wurde in Qt 6.9 eingeführt.

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

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

Gibt ein „ const_reverse_iterator “ zurück, das auf den Anfang des umgekehrten Abschnitts verweist.

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

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

Gibt einen „ const_reverse_iterator “ zurück, der auf eine Position verweist, die eine Position hinter dem Ende des umgekehrten Bereichs liegt.

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

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

Gibt einen Zeiger auf den Anfang des Bereichs zurück.

Entspricht dem Aufruf von ` begin()`.

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

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

Diese Funktionen haben dieselbe Funktion: ` empty()` dient der STL-Kompatibilität und ` isEmpty()` der Qt-Kompatibilität.

Siehe auch ` size()` und ` size_bytes()`.

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

Gibt einen Iterator zurück, der auf die Position unmittelbar nach dem Ende des Bereichs zeigt.

Da Iteratoren von „ QSpan “ lediglich Zeiger sind, entspricht dies dem 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 “-Span 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), andernfalls 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.

Der Bereich muss mindestens n Elemente enthalten (E >= n und size() >= n), andernfalls 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), sliced() und chopped().

[constexpr] auto QSpan::front() const

Gibt eine Referenz auf das erste Element im Span zurück.

Der Bereich darf nicht leer sein, andernfalls 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 “-Span der Größe „ Count “ zurück, die auf die letzten „ Count “-Elemente von „ *this “ verweist.

Der Bereich muss mindestens Count Elemente enthalten (E >= Count und size() >= Count), andernfalls 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.

Der Bereich muss mindestens n Elemente enthalten (E >= n und size() >= n), andernfalls 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), sliced() und chopped().

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

Gibt ein ` reverse_iterator ` zurück, das auf den Anfang des umgekehrten Bereichs verweist.

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

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

Gibt einen ` reverse_iterator ` zurück, der auf die Position unmittelbar hinter dem Ende des umgekehrten Bereichs zeigt.

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

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

Gibt die Größe des Spans 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 Spans in Bytes zurück, d. h. die Anzahl der Elemente multipliziert mit sizeof(T).

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

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

Genau wie unter *this = sliced(,pos und).

Diese Funktion ist nur unter variable-sized spans verfügbar.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch sliced().

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

Genau wie unter *this = sliced(,pos,,,n und).

Diese Funktion ist nur unter variable-sized spans verfügbar.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch sliced().

Gibt eine „ variable-sized “-Span der Größe „ size() - pos “ zurück, die auf den verbleibenden Teil dieser Span verweist, nachdem die ersten „ pos “-Elemente entfernt wurden.

pos muss nicht-negativ sein.

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

Diese Funktionen bewirken dasselbe: ` subspan()` dient der STL-Kompatibilität und ` sliced()` der Qt-Kompatibilität.

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

Gibt einen Bereich vom Typ „ variable-sized “ der Größe „ n “ zurück, der auf die Elemente „ n “ dieses Bereichs verweist, beginnend bei „ pos “.

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

Dieser Bereich muss mindestens pos + n Elemente enthalten (E >= pos + n und size() >= pos + n), andernfalls ist das Verhalten undefiniert.

Diese Funktionen haben denselben Zweck: ` subspan()` dient der STL-Kompatibilität und ` sliced()` der Qt-Kompatibilität.

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

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

Gibt einen Span der Größe „ Count “ zurück, der auf die Elemente „ Count “ dieses Spans verweist, beginnend bei „ Offset “.

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

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

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

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

Gibt einen Span der Größe „ E - Offset “ zurück, der auf den verbleibenden Teil dieses Spans verweist, nachdem die ersten „ Offset “ Elemente entfernt wurden.

Ist *this ein Span variabler Größe, ist der Rückgabetyp ein Span variabler Größe, andernfalls ein Span fester Größe.

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

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

Diese speziellen Mitgliedsfunktionen sind implizit definiert.

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

Gibt eine Referenz auf das Element am Index „ idx “ innerhalb des „span“-Elements zurück.

Der Index muss im zulässigen 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.