CKTIS / C++
std::span — uma vista sobre elementos contíguos
std::span permite aceder a elementos contíguos sem ser seu proprietário. Permite passar um intervalo juntamente com o seu tamanho, enquanto subspan cria uma vista de parte desse intervalo sem copiar elementos.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#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> é uma vista sobre elementos contíguos. Não é proprietário desses elementos nem prolonga o seu tempo de vida. Extent especifica um tamanho fixo no tipo; o valor predefinido std::dynamic_extent, como em std::span<T>, significa que o tamanho é determinado durante a execução.
std::span::size() devolve o número de elementos como size_type, e não o número de bytes. std::span::subspan(offset, count) cria uma vista a partir do índice offset, sem copiar dados. Se count for omitido ou se for passado explicitamente std::dynamic_extent, a vista abrange o resto do intervalo. Caso contrário, abrange count elementos. Esta sobrecarga devolve uma vista de tamanho dinâmico. subspan<Offset, Count>() recebe argumentos de modelo. Se Count != std::dynamic_extent, a extensão do resultado é fixa e igual a Count. Se Count == std::dynamic_extent, quer esse valor seja indicado explicitamente quer se use o valor predefinido, a extensão do resultado é dinâmica quando Extent == std::dynamic_extent; caso contrário, é fixa e igual a Extent - Offset.
Em C++23, é obrigatório que offset <= size() e, para um count explícito diferente de std::dynamic_extent, também que count <= size() - offset. A violação destas condições provoca comportamento indefinido, não uma exceção garantida. A sobrecarga de modelo também rejeita limites incompatíveis com a extensão codificada no tipo. size() e subspan() têm complexidade temporal constante.
Os dados têm de permanecer válidos enquanto a vista é utilizada; destruir o proprietário ou realocar o seu armazenamento pode invalidar o acesso. std::span<const T> impede a modificação dos elementos através da vista, ao contrário de const std::span<T>. O exemplo modifica o array original através de uma subvista. A fonte é um projeto de norma em evolução, pelo que esta descrição se limita deliberadamente às operações disponíveis em C++23.
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.