Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::views::enumerate — iterace s indexem

C++23 std::views::enumerate vytváří líný pohled, který každou položku rozsahu spojuje s indexem začínajícím od nuly. Cyklus tak může pracovat s indexem i položkou bez samostatně udržovaného čítače.

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

Syntaxe

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

std::views::enumerate, dostupné v <ranges>, je adaptér rozsahů z C++23. Zápis std::views::enumerate(range) nebo range | std::views::enumerate vytvoří std::ranges::enumerate_view. Pohled počítá výsledky při iteraci, místo aby vytvářel kontejner dvojic.

Dereferencování jeho iterátoru poskytne std::tuple obsahující index a výsledek dereferencování podkladového iterátoru. Index začíná na 0 a používá typ rozdílu podkladového rozsahu, který nemusí být std::size_t. V auto [index, value] si value zachovává referenční nebo proxy sémantiku rozsahu: u modifikovatelného std::array<int, 3> přiřazení do value změní původní položku navzdory použití auto.

Index označuje pozici v rozsahu předaném adaptéru. Pokud nejprve použijete filtr, číslování se vztahuje k filtrované posloupnosti, nikoli k původním pozicím. Pokud pohled odkazuje na existující kontejner, musí tento kontejner zůstat naživu; vyhněte se také operacím, které zneplatní používané iterátory.

Příklad zvýší hodnoty položek a vypíše jejich indexy. Vyžaduje kompilátor i standardní knihovnu podporující tento adaptér. Metadata repozitáře uvádějí příznak C++23, ale nepotvrzují produkční běhové prostředí. Citovaný dokument je průběžně upravovaný pracovní návrh, nikoli konečné vydání C++23.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje