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

CKTIS / C++

std::views::zip — společné procházení rozsahů

std::views::zip vytváří líný pohled na prvky na odpovídajících pozicích několika rozsahů. Iterace končí u nejkratšího rozsahu a přístup pomocí referencí umožňuje měnit upravitelné zdrojové prvky.

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

Syntaxe

#include <ranges>
std::views::zip(r1, r2, ...)

std::views::zip, dostupné v C++23 v <ranges>, spojuje odpovídající pozice rozsahů do líného pohledu. Nevytváří výsledný kontejner. Pro neprázdný seznam argumentů vytvoří std::ranges::zip_view a přizpůsobí vstupy pomocí std::views::all. Vstupy musí umožňovat toto přizpůsobení a podporovat alespoň vstupní iteraci.

Iterace končí, jakmile kterýkoli rozsah dosáhne konce: přebytečné prvky se přeskočí, bez doplňování a bez oznámení rozdílu délek. Pokud všechny vstupy poskytují velikost, size() vrátí nejmenší z nich. Volání std::views::zip() bez argumentů vytvoří prázdný pohled, jehož typem prvku je std::tuple<>.

Dereference vrací n-tici výsledků dereference vstupních iterátorů — obvykle reference, někdy však proxy objekty. Zápis auto&& [number, letter] umožňuje pracovat s těmito prvky bez kopírování jejich hodnot. Změna number v příkladu změní numbers. Pokud std::views::all přizpůsobí l-hodnotu pomocí reference, musí odkazovaný rozsah existovat po celou dobu, kdy jej výsledný pohled používá. Pokud lze pohled předaný jako l-hodnota z této l-hodnoty zkopírovat, std::views::all místo toho zkopíruje samotný pohled, nikoli nutně jeho prvky. Původní objekt std::ranges::single_view<int> může například zaniknout, zatímco výsledný pohled dál používá vlastní kopii. Paměť, kterou zkopírovaný pohled nadále používá, musí zůstat platná; nadále platí i pravidla pro zneplatnění iterátorů.

Příklad zpracuje pouze dva páry, takže třetí prvek numbers zůstane 3. Je potřeba standardní knihovna implementující tuto funkci C++23; samotný příznak kompilátoru nedokládá dostupnost ani funkčnost v produkčním běhovém prostředí.

Příklady

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

int main() {
    std::array<int, 3> numbers{1, 2, 3};
    std::array<char, 2> letters{'a', 'b'};

    for (auto&& [number, letter] : std::views::zip(numbers, letters)) {
        number *= 10;
        std::cout << number << ':' << letter << '\n';
    }
    std::cout << numbers[2] << '\n';
}

Výsledek

10:a
20:b
3

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