QSpan Class

Documentación de funciones miembro

[default] QSpan::QSpan()

Constructor por defecto.

Este constructor sólo está presente si E es cero (0) o std::dynamic_extent. En otras palabras: sólo los vanos de tamaño fijo-cero o variable son construibles por defecto.

Véase también extent y Variable-Size and Fixed-Size Spans.

Construye un QSpan que hace referencia a los datos del span suministrado other.

Restricciones

Participa en la resolución de sobrecargas sólo si

• N o extent son std::dynamic_extent o extent == N
• y S o const S son iguales a T.

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

Construye un QSpan referenciando los datos en el rango suministrado r.

Restricciones

Participa en la resolución de sobrecargas sólo si Range es a compatible range.

Construye un QSpan referenciando los datos del array suministrado arr.

Restricciones

Participa en la resolución de sobrecargas sólo si

• N o extent son std::dynamic_extent o en caso contrario extent == N
• y S o const S son iguales a T.

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

Construye un QSpan referenciando los datos de la lista inicializadora suministrada il.

Restricciones

Participa en la resolución de sobrecargas sólo si T es const-qualified.

Véase también Const and Mutable Spans.

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

Construye un QSpan referenciando los datos comenzando en first y teniendo la longitud (last - first).

[first, last) debe ser un rango válido.

Restricciones

Participa en la resolución de sobrecargas sólo si It es a compatible iterator.

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

Construye un QSpan referenciando los datos comenzando en first y teniendo la longitud count.

[first, count) debe ser un rango válido.

Restricciones

Participa en la resolución de sobrecargas sólo si It es a compatible iterator.

Estas Funciones Miembro Especiales están implícitamente definidas.

[constexpr] auto QSpan::back() const

Devuelve una referencia al último elemento del span.

El span no debe estar vacío, de lo contrario el comportamiento es indefinido.

Véase también operator[](), front(), size(), empty(), y Const and Mutable Spans.

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

Devuelve un iterador que apunta al principio del tramo.

Dado que los iteradores de QSpan son sólo punteros, es lo mismo que llamar a data().

Ver también end(), cbegin(), rbegin(), crbegin(), data(), y Const and Mutable Spans.

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

Devuelve un const_iterator que apunta al principio del span.

Esto devolverá un iterador de sólo lectura incluso si T no es const:

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

Ver también cend(), begin(), crbegin(), rbegin(), data(), y Const and Mutable Spans.

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

Devuelve un const_iterator que apunta a uno pasado el final del tramo.

Véase también cbegin(), end(), crend(), rend(), data(), size() y Const and Mutable Spans.

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

Igual que *this = chopped(n ) .

Esta función sólo está disponible en variable-sized spans.

Esta función se introdujo en Qt 6.9.

Véase también chopped().

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

Devuelve un variable-sized span de tamaño size() - n referenciando los primeros size() - n elementos de este span.

Igual que first(size() - n).

n debe ser no negativo.

Este span debe contener al menos n elementos (E >= n y size() >= n), de lo contrario el comportamiento es indefinido.

Esta función se introdujo en Qt 6.9.

Ver también subspan(), first(QSpan<T,E>::size_type), last(QSpan<T,E>::size_type), y chop().

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

Devuelve un const_reverse_iterator que apunta al principio del tramo invertido.

Véase también crend(), rbegin(), cbegin(), begin() y Const and Mutable Spans.

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

Devuelve un const_reverse_iterator que apunta a uno más allá del final del tramo invertido.

Véase también crbegin(), rend(), cend(), end() y Const and Mutable Spans.

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

Devuelve un puntero al principio del tramo.

Es lo mismo que llamar a begin().

Véase también begin(), front() y Const and Mutable Spans.

Devuelve si el span está vacío, es decir, si size() == 0.

Estas funciones hacen lo mismo: empty() se proporciona por compatibilidad con STL y isEmpty() se proporciona por compatibilidad con Qt.

Véase también size() y size_bytes().

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

Devuelve un iterador que apunta a uno más allá del final del tramo.

Dado que los iteradores de QSpan son sólo punteros, es lo mismo que llamar a data() + size().

Ver también begin(), cend(), rend(), crend(), data(), size(), y Const and Mutable Spans.

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

Devuelve un fixed-sized span de tamaño Count que hace referencia a los primeros Count elementos de *this.

El span debe contener al menos Count elementos (E >= Count y size() >= Count), de lo contrario el comportamiento es indefinido.

Ver también first(QSpan<T,E>::size_type), last(), y subspan().

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

Devuelve un variable-sized span de tamaño n que hace referencia a los primeros n elementos de *this.

n debe ser no negativo.

El span debe contener al menos n elementos (E >= n y size() >= n), de lo contrario el comportamiento es indefinido.

Véase también 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(), y chopped().

[constexpr] auto QSpan::front() const

Devuelve una referencia al primer elemento del span.

El span no debe estar vacío, de lo contrario el comportamiento es indefinido.

Véase también operator[](), back(), size(), empty(), y Const and Mutable Spans.

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

Devuelve un span fixed-sized de tamaño Count que hace referencia a los últimos elementos Count de *this.

El span debe contener al menos Count elementos (E >= Count y size() >= Count), de lo contrario el comportamiento es indefinido.

Ver también last(QSpan<T,E>::size_type), first(), y subspan().

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

Devuelve un variable-sized span de tamaño n que hace referencia a los últimos n elementos de *this.

n debe ser no negativo.

El span debe contener al menos n elementos (E >= n y size() >= n), de lo contrario el comportamiento es indefinido.

Véase también 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(), y chopped().

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

Devuelve un reverse_iterator que apunta al principio del tramo invertido.

Véase también rend(), crbegin(), begin(), cbegin() y Const and Mutable Spans.

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

Devuelve un reverse_iterator que apunta a uno más allá del final del tramo invertido.

Véase también rbegin(), crend(), end(), cend() y Const and Mutable Spans.

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

Devuelve el tamaño del span, es decir, el número de elementos a los que hace referencia.

Véase también size_bytes(), empty() y isEmpty().

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

Devuelve el tamaño del span en bytes, es decir, el número de elementos multiplicado por sizeof(T).

Véase también size(), empty() y isEmpty().

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

Igual que *this = sliced(pos ) .

Esta función sólo está disponible en variable-sized spans.

Esta función se introdujo en Qt 6.9.

Véase también sliced().

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

Igual que *this = sliced(pos , n ) .

Esta función sólo está disponible en variable-sized spans.

Esta función se introdujo en Qt 6.9.

Véase también sliced().

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

Devuelve un span de tamaño Count referenciando los elementos Count de este span comenzando en Offset.

Si *this es un span de tamaño variable, el tipo devuelto es un span de tamaño variable, en caso contrario es un span de tamaño fijo.

Este span debe contener al menos Offset + Count elementos (E >= Offset + Count y size() >= Offset + Count), de lo contrario el comportamiento es indefinido.

Véase también subspan(QSpan<T,E>::size_type, QSpan<T,E>::size_type), first(), last(), y Variable-Size and Fixed-Size Spans.

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

Devuelve un tramo de tamaño E - Offset que hace referencia al resto de este tramo después de eliminar los primeros elementos de Offset.

Si *this es un span de tamaño variable, el tipo devuelto es un span de tamaño variable, en caso contrario es un span de tamaño fijo.

Este span debe contener al menos Offset elementos (E >= Offset y size() >= Offset), de lo contrario el comportamiento es indefinido.

Véase también subspan(QSpan<T,E>::size_type), subspan(), first(), last(), y Variable-Size and Fixed-Size Spans.

Devuelve un tramo variable-sized de tamaño size() - pos que hace referencia al resto de este tramo después de eliminar los primeros elementos pos.

pos debe ser no negativo.

Este span debe contener al menos pos elementos (E >= pos y size() >= pos), de lo contrario el comportamiento es indefinido.

Estas funciones hacen lo mismo: subspan() se proporciona por compatibilidad con STL y sliced() se proporciona por compatibilidad con Qt.

Véase también subspan(), first(QSpan<T,E>::size_type), last(QSpan<T,E>::size_type), chopped(), y slice().

Devuelve un variable-sized span de tamaño n referenciando los n elementos de este span comenzando en pos.

Tanto pos como n deben ser no negativos.

Este span debe contener al menos pos + n elementos (E >= pos + n y size() >= pos + n), de lo contrario el comportamiento es indefinido.

Estas funciones hacen lo mismo: subspan() se proporciona por compatibilidad con STL y sliced() se proporciona por compatibilidad con Qt.

Véase también subspan(), first(QSpan<T,E>::size_type), last(QSpan<T,E>::size_type), chopped(), y slice().

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

Devuelve una referencia al elemento en el índice idx en el span.

El índice debe estar dentro del rango, es decir, idx >= 0 y idx < size(), de lo contrario el comportamiento es indefinido.

Véase también front(), back(), size(), empty() y Const and Mutable Spans.