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

CKTIS / C++

std::views::drop — ignorer les N premiers éléments

std::views::drop crée une vue d’une plage sans ses N premiers éléments, sans les supprimer du conteneur. On peut utiliser l’appel à deux arguments ou la syntaxe par pipeline. Le nombre d’éléments à ignorer doit être non négatif.

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

Syntaxe

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

std::views::drop, disponible via <ranges>, est un objet adaptateur de plage. L’écriture std::views::drop(range, count) ou range | std::views::drop(count) donne une vue qui ignore des éléments au début de la plage. Le nombre de positions à ignorer est déterminé par la valeur de count après conversion vers le type de différence des itérateurs de la plage. Si la valeur convertie est nulle, la vue contient tous les éléments ; si elle est supérieure ou égale à la longueur d’une plage finie, le résultat est vide.

L’adaptateur ne supprime pas les éléments du conteneur et ne crée pas non plus un nouveau conteneur contenant des copies des valeurs restantes. Le résultat est généralement une std::ranges::drop_view, mais la norme prévoit une autre vue équivalente pour certains types de plages. Ne présumez donc pas d’un type de résultat particulier ; utilisez auto.

count doit être convertible vers le type de différence des itérateurs de la plage. La valeur fournie et la valeur convertie doivent toutes deux être non négatives. Une valeur négative ne signifie pas que l’on ignore des éléments depuis la fin. Si la vue fait référence à un conteneur existant, celui-ci doit rester en vie pendant l’utilisation de la vue ; les opérations qui invalident ses itérateurs peuvent également rendre l’utilisation de la vue dangereuse.

L’opération n’a pas toujours un coût constant : trouver le début peut nécessiter de parcourir les éléments ignorés. Pour une plage satisfaisant forward_range, drop_view mémorise le début calculé lorsque cela est nécessaire pour respecter les exigences de complexité. Dans l’exemple, values contient toujours cinq éléments, tandis que parcourir tail affiche 30 40 50.

Exemples

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

int main() {
    std::array<int, 5> values{10, 20, 30, 40, 50};
    auto tail = values | std::views::drop(2);

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

Résultat

30 40 50

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