Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::span — una vista de elementos contiguos

std::span permite acceder a elementos contiguos sin ser su propietario. Permite pasar un rango junto con su tamaño, mientras que subspan crea una vista de parte de ese rango sin copiar los elementos.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <span>
// Default construction is allowed only for extent 0 or std::dynamic_extent.
std::span<T> empty; // Extent defaults to std::dynamic_extent.
std::span<T> view{data, count};
view.size();
view.subspan(offset, count);
view.subspan<Offset, Count>();

std::span<T, Extent> de <span> es una vista de elementos contiguos. No es propietaria de esos elementos ni prolonga su vida útil. Extent especifica un tamaño fijo en el tipo; el valor predeterminado std::dynamic_extent, como en std::span<T>, significa que el tamaño se determina en tiempo de ejecución.

std::span::size() devuelve la cantidad de elementos como size_type, no la cantidad de bytes. std::span::subspan(offset, count) crea una vista a partir del índice offset, sin copiar los datos. Si se omite count o se pasa explícitamente std::dynamic_extent, la vista abarca el resto del rango. De lo contrario, abarca count elementos. Esta sobrecarga devuelve una vista de tamaño dinámico. subspan<Offset, Count>() recibe argumentos de plantilla. Si Count != std::dynamic_extent, el resultado tiene una extensión fija igual a Count. Si Count == std::dynamic_extent, tanto si se indica ese valor explícitamente como si se usa el predeterminado, la extensión del resultado es dinámica cuando Extent == std::dynamic_extent; de lo contrario, es fija e igual a Extent - Offset.

En C++23 se requiere offset <= size() y, si count es explícito y distinto de std::dynamic_extent, también count <= size() - offset. Incumplir estas condiciones provoca comportamiento indefinido, no una excepción garantizada. La sobrecarga de plantilla también rechaza límites incompatibles con la extensión codificada en el tipo. size() y subspan() tienen complejidad temporal constante.

Los datos deben seguir siendo válidos mientras se utiliza la vista; destruir el propietario o realojar su almacenamiento puede invalidar el acceso. std::span<const T> impide modificar los elementos a través de la vista, mientras que const std::span<T> no lo hace. El ejemplo modifica el array original mediante una subvista. La fuente es un borrador de norma en evolución, así que esta descripción se limita deliberadamente a las operaciones disponibles en C++23.

Ejemplos

#include <iostream>
#include <span>

int main() {
    int values[]{10, 20, 30, 40};
    std::span<int> all{values};
    auto middle = all.subspan(1, 2);
    middle[0] = 25;

    std::cout << all.size() << ' ' << middle.size() << '\n';
    std::cout << values[1] << ' ' << middle[1] << '\n';
}

Resultado

4 2
25 30

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes