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

CKTIS / C++

std::views::zip — percorrer intervalos em conjunto

std::views::zip cria uma vista preguiçosa dos elementos em posições correspondentes de vários intervalos. A iteração termina no intervalo mais curto e o acesso por referência permite modificar elementos de origem modificáveis.

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

Sintaxe

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

std::views::zip, disponível em C++23 em <ranges>, combina posições correspondentes de vários intervalos numa vista preguiçosa. Não constrói um contentor de resultado. Para uma lista de argumentos não vazia, cria uma std::ranges::zip_view, adaptando as entradas através de std::views::all. As entradas têm de permitir essa adaptação e suportar, pelo menos, iteração de entrada.

A iteração termina quando qualquer intervalo chega ao fim: os elementos excedentes são ignorados, sem preenchimento nem indicação de diferença de comprimento. Se todas as entradas fornecerem um tamanho, size() devolve o menor. Uma chamada a std::views::zip() sem argumentos produz uma vista vazia cujo tipo de elemento é std::tuple<>.

A desreferenciação produz um tuplo dos resultados da desreferenciação dos iteradores de entrada — normalmente referências, mas por vezes objetos proxy. Com auto&& [number, letter], pode trabalhar com estes elementos sem copiar os respetivos valores. Alterar number no exemplo altera numbers. Se std::views::all adaptar um lvalue por referência, o intervalo referenciado tem de continuar a existir enquanto a vista resultante o usar. Se, pelo contrário, a vista passada como argumento puder ser copiada a partir do lvalue fornecido, std::views::all copia a própria vista, não necessariamente os seus elementos. Por exemplo, o objeto std::ranges::single_view<int> original pode ser destruído enquanto a vista resultante continua a usar a sua própria cópia. A memória subjacente que a cópia ainda utilizar tem de permanecer válida, e as regras de invalidação de iteradores continuam a aplicar-se.

O exemplo processa apenas dois pares, pelo que o terceiro elemento de numbers permanece igual a 3. É necessária uma biblioteca-padrão que implemente esta funcionalidade de C++23; a opção do compilador, por si só, não comprova a disponibilidade nem o funcionamento num ambiente de produção.

Exemplos

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

Resultado

10:a
20:b
3

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