Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::views::filter — filtrage différé d’une plage

std::views::filter crée une vue différée des éléments qui satisfont un prédicat. Il ne construit pas de conteneur de résultats distinct et conserve l’ordre des éléments sélectionnés.

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

Syntaxe

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

std::views::filter de <ranges> est un adaptateur de plage qui crée une std::ranges::filter_view. Les formes std::views::filter(range, pred) et range | std::views::filter(pred) sélectionnent les éléments pour lesquels le prédicat est vrai, sans modifier leur ordre.

Le filtrage est différé : les éléments correspondants sont recherchés lors de l’obtention du début et de l’avancement des itérateurs, plutôt que par la construction d’un conteneur de résultats. La plage sous-jacente doit être au moins une plage d’entrée, et le prédicat doit satisfaire indirect_unary_predicate pour son itérateur. Ne faites pas dépendre la logique du programme du nombre d’appels au prédicat.

Pour un conteneur passé comme lvalue, la vue fait référence aux données existantes : le conteneur doit rester vivant. Gardez également la vue elle-même en vie tant que vous utilisez ses itérateurs. La vue ne protège pas contre l’invalidation des itérateurs. Ne modifiez pas un élément sélectionné via un itérateur de façon à ce qu’il cesse de satisfaire le prédicat.

Pour une plage à parcours avant, begin() met en cache la première correspondance ; la vue n’est donc pas un instantané automatiquement actualisé après des modifications arbitraires des données. L’exemple additionne les nombres pairs sélectionnés et devrait afficher 12 suivi d’un saut de ligne.

Exemples

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

Résultat

12

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources