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

CKTIS / C++

std::views::all — vista de um intervalo completo

std::views::all adapta um intervalo à interface de vista, mantendo todos os elementos. O resultado pode ser uma cópia ou uma transferência de uma vista existente, uma vista de referência ou uma vista proprietária; essa escolha determina como gerir o tempo de vida dos dados.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <ranges>
std::views::all(r)
r | std::views::all

std::views::all, declarado em <ranges>, é um objeto adaptador de intervalos. As expressões std::views::all(r) e r | std::views::all produzem uma vista de todos os elementos, sem filtrar nem transformar os respetivos valores. O argumento tem de satisfazer std::ranges::viewable_range.

A seleção segue uma ordem fixa: se o tipo do argumento, depois de remover referências e qualificadores, modelar std::ranges::view, o resultado é um objeto desse tipo, copiado ou transferido de acordo com a categoria de valor. Caso contrário, é produzido std::ranges::ref_view se for possível construí-lo; se não, é produzido std::ranges::owning_view. Nem todas as vistas podem ser passadas como lvalues: uma vista que só pode ser transferida pode exigir std::move.

Para um lvalue std::vector<int>, o resultado refere-se ao vetor existente; para um std::vector<int> temporário, assume a propriedade do vetor. Um ref_view não prolonga o tempo de vida da origem. A origem tem de continuar viva enquanto a vista estiver a ser usada, e as regras de invalidação de iteradores do contentor continuam a aplicar-se. Quando o vetor é passado como lvalue, all não copia os elementos. Em contrapartida, passar como lvalue uma vista que admite cópia pode levar à cópia tanto da vista como dos elementos que esta armazena: uma cópia de std::ranges::single_view<int> armazena o seu próprio int.

O exemplo demonstra os dois casos: escrever através de borrowed altera values, enquanto owned armazena o seu próprio vetor. O resultado esperado são duas linhas com 9. O repositório usa a opção C++23; a compatibilidade de execução em produção não está atestada.

Exemplos

#include <iostream>
#include <ranges>
#include <type_traits>
#include <vector>

int main() {
    std::vector<int> values{1, 2, 3};
    auto borrowed = values | std::views::all;
    auto owned = std::views::all(std::vector<int>{4, 5});

    static_assert(std::is_same_v<decltype(borrowed),
                  std::ranges::ref_view<std::vector<int>>>);
    static_assert(std::is_same_v<decltype(owned),
                  std::ranges::owning_view<std::vector<int>>>);

    borrowed.front() = 9;
    std::cout << values.front() << '\n';

    int sum = 0;
    for (int value : owned) {
        sum += value;
    }
    std::cout << sum << '\n';
}

Resultado

9
9

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