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::enumeratestd::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.