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

CKTIS / C++

std::views::filter — filtragem diferida de intervalos

std::views::filter cria uma vista diferida dos elementos que satisfazem um predicado. Não constrói um contentor de resultados separado e preserva a ordem dos elementos selecionados.

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

Sintaxe

#include <ranges>
std::views::filter(range, pred)
range | std::views::filter(pred)

std::views::filter de <ranges> é um adaptador de intervalo que cria uma std::ranges::filter_view. Tanto std::views::filter(range, pred) como range | std::views::filter(pred) selecionam os elementos para os quais o predicado é verdadeiro, sem alterar a sua ordem.

A filtragem é diferida: as correspondências são procuradas ao obter o início e avançar os iteradores, em vez de se construir um contentor de resultados. O intervalo subjacente tem de ser, no mínimo, um intervalo de entrada, e o predicado tem de satisfazer indirect_unary_predicate para o seu iterador. Não faças depender a lógica do programa do número de chamadas ao predicado.

Para um contentor passado como lvalue, a vista refere-se aos dados existentes: o contentor tem de permanecer vivo. Mantém também a própria vista viva enquanto usares os seus iteradores. A vista não protege contra a invalidação de iteradores. Não alteres um elemento selecionado através de um iterador de modo a que deixe de satisfazer o predicado.

Para um intervalo de passagem em frente, begin() coloca em cache a primeira correspondência; por isso, a vista não é uma captura automaticamente atualizada após alterações arbitrárias dos dados. O exemplo soma os números pares selecionados e deverá apresentar 12 seguido de uma mudança de linha.

Exemplos

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

int main() {
    std::array<int, 6> values{1, 2, 3, 4, 5, 6};
    auto evens = values | std::views::filter([](int x) {
        return x % 2 == 0;
    });

    int sum = 0;
    for (int x : evens) {
        sum += x;
    }
    std::cout << sum << '\n';
}

Resultado

12

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