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

CKTIS / C++

std::views::take_while — un préfixe qui satisfait une condition

std::views::take_while crée une vue paresseuse des éléments initiaux d’une plage qui satisfont un prédicat. Elle s’arrête avant le premier élément qui ne satisfait pas la condition et ne reprend pas la recherche des correspondances suivantes.

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

Syntaxe

std::views::take_while(range, pred)
range | std::views::take_while(pred)

std::views::take_while est un adaptateur de plages qui crée une std::ranges::take_while_view. Utilisez std::views::take_while(range, pred) ou range | std::views::take_while(pred). La vue comprend les éléments consécutifs depuis le début jusqu’au premier résultat false, sans inclure l’élément qui l’a provoqué. Si le premier élément ne satisfait pas la condition, le résultat est vide ; si tous les éléments la satisfont, la vue couvre toute la plage.

La vue est paresseuse : sa création ne construit pas de conteneur de résultat distinct. La condition est vérifiée pendant l’itération, lors de la comparaison de l’itérateur avec la sentinelle de fin. Ne supposez pas que le prédicat est appelé exactement une fois par élément et ne faites pas dépendre le résultat d’un compteur d’appels. Le prédicat doit satisfaire indirect_unary_predicate<const Pred, iterator_t<V>>, et la vue sous-jacente V doit satisfaire input_range.

Dans l’exemple, x < 5 accepte 2 et 4 ; 7 met fin à la vue. Les valeurs 1 et 3 qui suivent ne sont pas incluses : il s’agit de sélectionner un préfixe, et non tous les éléments correspondants. Le tableau values doit rester en vie pendant l’utilisation de la vue qui le référence.

Pour une entrée à parcours unique, comme un flux, la détection de l’élément d’arrêt peut déjà le lire depuis la source. Ne supposez donc pas qu’il sera encore disponible pour la prochaine extraction du flux.

Exemples

#include <iostream>
#include <ranges>

int main() {
    int values[] = {2, 4, 7, 1, 3};
    auto prefix = values | std::views::take_while([](int x) {
        return x < 5;
    });

    bool first = true;
    for (int x : prefix) {
        if (!first) std::cout << ' ';
        std::cout << x;
        first = false;
    }
    std::cout << '\n';
}

Résultat

2 4

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