Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes