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

CKTIS / C++

std::views::enumerate — iteração com índice

C++23 std::views::enumerate cria uma vista preguiçosa que associa cada elemento de um intervalo a um índice iniciado em zero. Permite aceder ao índice e ao elemento num ciclo sem manter um contador separado.

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

Sintaxe

std::views::enumerate(range)
range | std::views::enumerate

std::views::enumerate, disponível em <ranges>, é um adaptador de intervalos de C++23. Escrever std::views::enumerate(range) ou range | std::views::enumerate cria uma std::ranges::enumerate_view. A vista calcula os resultados durante a iteração, em vez de construir um contentor de pares.

A desreferenciação do seu iterador produz um std::tuple que contém um índice e o resultado da desreferenciação do iterador subjacente. O índice começa em 0 e utiliza o tipo de diferença do intervalo subjacente, que não é necessariamente std::size_t. Em auto [index, value], value mantém a semântica de referência ou proxy do intervalo: num std::array<int, 3> modificável, atribuir a value altera o elemento original apesar do uso de auto.

O índice indica uma posição no intervalo passado ao adaptador. Se aplicar primeiro um filtro, a numeração diz respeito à sequência filtrada e não às posições originais. Quando a vista faz referência a um contentor existente, este tem de continuar válido; evite também operações que invalidem os iteradores utilizados.

O exemplo incrementa os elementos e imprime os respetivos índices. Requer tanto um compilador como uma biblioteca padrão que suportem este adaptador. Os metadados do repositório indicam uma opção C++23, mas não atestam o ambiente de execução de produção. O documento citado é um rascunho de trabalho em evolução, não uma publicação definitiva de C++23.

Exemplos

#include <array>
#include <iostream>
#include <ranges>
#include <tuple>

int main() {
    std::array<int, 3> values{10, 20, 30};
    for (auto [index, value] : values | std::views::enumerate) {
        value += 1;
        std::cout << index << ':' << value << '\n';
    }
    std::cout << "first=" << values[0] << '\n';
}

Resultado

0:11
1:21
2:31
first=11

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