Namespaces
Variants

std::ranges:: views:: drop, std::ranges:: drop_view

From cppreference.net
C++
Ranges library
Range adaptors
std::ranges::drop_view
Défini dans l'en-tête <ranges>
template < ranges:: view V >

class drop_view

: public ranges:: view_interface < drop_view < V >>
(1) (depuis C++20)
namespace views {

inline constexpr /* non spécifié */ drop = /* non spécifié */ ;

}
(2) (depuis C++20)
Signature d'appel
template < ranges:: viewable_range R >

requires /* voir ci-dessous */
constexpr ranges:: view auto

drop ( R && r, ranges:: range_difference_t < R > count ) ;
(depuis C++20)
template < class DifferenceType >
constexpr /* adaptateur de plage de fermeture */ drop ( DifferenceType && count ) ;
(depuis C++20)
1) Un adaptateur de gamme constitué des éléments de la séquence sous-jacente, en ignorant les premiers N éléments.
2) RangeAdaptorObject . Given T is std:: remove_cvref_t < decltype ( ( e ) ) > and D is ranges:: range_difference_t < decltype ( ( e ) ) > ), the expression vues :: drop ( e, f ) is expression-équivalente to:
  • views:: repeat ( * e. value_ , ranges:: distance ( e ) - inc ) , si T modélise sized_range ; dans ce cas e n'est évalué qu'une seule fois ;
  • ( ( void ) e, auto ( f ) ) sinon, sauf que les évaluations de e et f sont séquencées de manière indéterminée ;
(depuis C++23)
  • sinon, drop_view ( e, f ) .
In all cases, decltype ( ( f ) ) must model std:: convertible_to < D > .

drop_view modélise les concepts contiguous_range , random_access_range , bidirectional_range , forward_range , input_range , common_range , et sized_range lorsque la vue sous-jacente V modélise les concepts respectifs.

Table des matières

Membres de données

Membre Description
V base_ (privé) la vue sous-jacente
( objet membre d'exposition seulement* )
ranges:: range_difference_t < V > count_ (privé) le nombre d'éléments à ignorer
( objet membre d'exposition seulement* )
non-propagating-cache < ranges:: iterator_t < V >> cache_ (privé)
(présent seulement si V satisfait forward_range mais pas random_access_range et sized_range ) 		un objet qui met en cache le résultat des appels à begin()
( objet membre d'exposition seulement* )

Fonctions membres

construit un drop_view
(fonction membre publique)
retourne une copie de la vue sous-jacente (adaptée)
(fonction membre publique)
retourne un itérateur vers le début
(fonction membre publique)
retourne un itérateur ou un sentinelle vers la fin
(fonction membre publique)
retourne le nombre d'éléments, fourni uniquement si la plage sous-jacente (adaptée) satisfait sized_range
(fonction membre publique)
(C++26)
retourne la taille approximative de la approximately_sized_range résultante
(fonction membre publique)
Hérité de std::ranges::view_interface
indique si la vue dérivée est vide, fourni uniquement si elle satisfait sized_range ou forward_range
(fonction membre publique de std::ranges::view_interface<D> )
(C++23)
retourne un itérateur constant vers le début de la plage
(fonction membre publique de std::ranges::view_interface<D> )
(C++23)
retourne un sentinelle pour l'itérateur constant de la plage
(fonction membre publique de std::ranges::view_interface<D> )
indique si la vue dérivée n'est pas vide, fourni uniquement si ranges::empty lui est applicable
(fonction membre publique de std::ranges::view_interface<D> )
obtient l'adresse des données de la vue dérivée, fourni uniquement si son type d'itérateur satisfait contiguous_iterator
(fonction membre publique de std::ranges::view_interface<D> )
retourne le premier élément de la vue dérivée, fourni si elle satisfait forward_range
(fonction membre publique de std::ranges::view_interface<D> )
retourne le dernier élément de la vue dérivée, fourni uniquement si elle satisfait bidirectional_range et common_range
(fonction membre publique de std::ranges::view_interface<D> )
retourne le n ème élément de la vue dérivée, fourni uniquement si elle satisfait random_access_range
(fonction membre publique de std::ranges::view_interface<D> )

Guides de déduction

Modèles d'assistance

template < class T >

constexpr bool enable_borrowed_range < std :: ranges :: drop_view < T >> =

ranges:: enable_borrowed_range < T > ;
(depuis C++20)

Cette spécialisation de ranges::enable_borrowed_range permet à drop_view de satisfaire borrowed_range lorsque la vue sous-jacente la satisfait.

Exemple

Exécuter ce code 
#include <initializer_list>
#include <iostream>
#include <ranges>
int main()
{
    const auto nums = {1, 2, 3, 4, 5, 6, 7};
    std::cout << "drop " << 2 << ": ";
    for (int i : std::ranges::drop_view{nums, 2})
        std::cout << i << ' ';
    std::cout << '\n';
    std::cout << "drop " << 3 << ": ";
    for (int i : nums | std::views::drop(3))
        std::cout << i << ' ';
    std::cout << '\n';
    std::cout << "drop " << 4 << ": ";
    for (int i : std::views::iota(1, 8) | std::views::drop(4))
        std::cout << i << ' ';
    std::cout << '\n';
    // Notez que supprimer plus d'éléments que le nombre total est acceptable :
    for (int dp : {5, 6, 7, 890, 100500})
    {
        std::cout << "drop " << dp << ": ";
        for (int i : std::views::iota(1, 8) | std::views::drop(dp))
            std::cout << i << ' ';
        std::cout << '\n';
    }
}

Sortie : 

drop 2: 3 4 5 6 7
drop 3: 4 5 6 7
drop 4: 5 6 7
drop 5: 6 7
drop 6: 7
drop 7:
drop 890: 
drop 100500:

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

DR Applicable à Comportement publié Comportement corrigé
LWG 3407 C++20 views::drop échoue parfois à
construire une plage à accès aléatoire dimensionnée 		la construction est ajustée
pour qu'elle soit toujours valide
LWG 3494 C++20 drop_view n'était jamais une borrowed_range c'est une borrowed_range si sa vue sous-jacente l'est

Voir aussi

(C++20)
une view constituée des éléments d'une autre view , ignorant la sous-séquence initiale des éléments jusqu'au premier élément où le prédicat retourne false
(modèle de classe) (objet adaptateur de gamme)