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

CKTIS / C++

std::views::take — une vue des premiers éléments d’une plage

std::views::take, fourni par <ranges>, crée une vue d’au plus count éléments initiaux d’une plage. Il en conserve l’ordre, ne crée pas de conteneur distinct et s’utilise aussi bien par appel direct qu’en notation de pipeline.

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

Syntaxe

#include <ranges>
std::views::take(range, count)
range | std::views::take(count)

std::views::take est un objet adaptateur de plage fourni par <ranges>. L’expression std::views::take(range, count) correspond à range | std::views::take(count). Si count est positif ou nul et représentable dans le type de différence des itérateurs de la plage, le résultat expose les count premiers éléments dans leur ordre d’origine, ou toute la plage si elle contient moins d’éléments. Si count vaut 0, le résultat est vide.

Il s’agit d’une vue, pas d’un conteneur copié : l’application de l’adaptateur ne copie pas les éléments dans une nouvelle collection et ne supprime pas les éléments de fin de la source. Les éléments sont lus lors de l’itération. Le résultat n’est pas nécessairement de type std::ranges::take_view ; la norme prévoit d’autres représentations de vue équivalentes pour certains types de plages. auto est donc généralement approprié.

L’argument count doit pouvoir être converti dans le type de différence des itérateurs de la plage. Utilisez une valeur positive ou nulle, représentable dans ce type, même lorsque l’adaptateur ne construit pas de std::ranges::take_view. Par exemple, dans le cas optimisé de std::span, l’adaptateur convertit count dans ce type avant de prendre le minimum entre la valeur convertie et la longueur de la plage. Une valeur non signée trop grande pour être représentée peut donner -1 après conversion et entraîner un calcul invalide sur les itérateurs au lieu de sélectionner toute la plage. Lorsque l’adaptateur construit une std::ranges::take_view, le constructeur exige que la valeur après conversion soit positive ou nulle. Une valeur négative ne signifie pas que l’on compte à partir de la fin. Si la plage d’entrée est d’un type qui est une spécialisation de std::ranges::empty_view, l’adaptateur évalue l’argument count puis en ignore la valeur sans construire de std::ranges::take_view ; une valeur négative ne viole donc pas cette précondition.

Lorsqu’un conteneur existant est adapté à partir d’une lvalue, la vue fait référence à ce conteneur. La source doit donc rester en vie pendant l’utilisation de la vue, et les opérations qui invalident les itérateurs peuvent également invalider l’accès par la vue. Dans l’exemple, la modification de values[0] après la création de first apparaît dans le résultat : 11 20 30. Le code présenté a été exécuté sans modification dans un environnement isolé. Sa sortie standard correspondait exactement à la sortie indiquée.

Exemples

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

int main() {
    std::array<int, 5> values{10, 20, 30, 40, 50};
    auto first = values | std::views::take(3);
    values[0] = 11;

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

Résultat

11 20 30

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