Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::views::enumerate — iteracja z indeksem

std::views::enumerate z C++23 tworzy leniwy widok łączący każdy element zakresu z indeksem liczonym od zera. Pozwala korzystać z indeksu i elementu w jednej pętli, bez ręcznego aktualizowania licznika.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

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

std::views::enumerate, dostępne w <ranges>, jest adaptorem zakresów z C++23. Zapis std::views::enumerate(range) lub range | std::views::enumerate tworzy std::ranges::enumerate_view. Widok oblicza wyniki podczas iteracji, zamiast tworzyć kontener par.

Dereferencja iteratora daje std::tuple zawierającą indeks oraz wynik dereferencji iteratora bazowego. Indeks zaczyna się od 0 i ma typ różnicowy zakresu bazowego, niekoniecznie std::size_t. W auto [index, value] element value zachowuje semantykę referencji lub obiektu pośredniczącego zakresu: dla modyfikowalnej std::array<int, 3> przypisanie do value zmienia oryginalny element mimo użycia auto.

Indeks opisuje pozycję w zakresie przekazanym do adaptora. Jeśli wcześniej zastosujesz filtr, numeracja dotyczy przefiltrowanej sekwencji, a nie pierwotnych pozycji. Gdy widok odwołuje się do istniejącego kontenera, kontener musi pozostać przy życiu; unikaj też operacji unieważniających używane iteratory.

Przykład zwiększa elementy i wypisuje ich indeksy. Wymaga kompilatora oraz biblioteki standardowej obsługujących ten adaptor. Metadane repozytorium wskazują flagę C++23, lecz nie potwierdzają środowiska wykonawczego produkcji. Cytowany dokument jest rozwijanym szkicem standardu, a nie zamrożoną publikacją C++23.

Przykłady

#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';
}

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła