Namespaces
Variants

operator- (std::common_iterator)

From cppreference.net
C++
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
std::common_iterator
template < std:: sized_sentinel_for < I > I2, std:: sized_sentinel_for < I > S2 >

requires std:: sized_sentinel_for < S, I2 >
friend constexpr std:: iter_difference_t < I2 >

operator - ( const common_iterator & x, const std:: common_iterator < I2, S2 > & y ) ;
(depuis C++20)

Calcule la distance entre deux adaptateurs d'itérateur. Deux sentinelles sont considérées égales.

Soit var l'objet membre sous-jacent de type std::variant dans std::common_iterator , le comportement est indéfini si x ou y est invalide, c'est-à-dire si x. var . valueless_by_exception ( ) || y. var . valueless_by_exception ( ) est true .

Ce modèle de fonction n'est pas visible par la recherche unqualified ou qualified ordinaire, et ne peut être trouvé que par la recherche argument-dependent lorsque std::common_iterator<I> est une classe associée des arguments.

Table des matières

Paramètres

x, y - adaptateurs d'itérateur pour calculer la différence de

Valeur de retour

  • ​ 0 ​ si x. var contient un objet S et y. var contient un objet S2 , c'est-à-dire que les deux contiennent une sentinelle.
  • Sinon, alt_x - alt_y , où alt_x et alt_y sont les alternatives contenues par x. var et y. var , respectivement (soit deux itérateurs, soit un itérateur et une sentinelle).

Exemple

Exécuter ce code 
#include <algorithm>
#include <iostream>
#include <iterator>
int main()
{
    int a[]{0, 1, 2, 3, 4, 5};
    using CI = std::common_iterator<
                   std::counted_iterator<int*>,
                   std::default_sentinel_t
                   >;
    CI i1{std::counted_iterator{a + 1, 2}};
    CI i2{std::counted_iterator{a, 3}};
    CI s1{std::default_sentinel};
    CI s2{std::default_sentinel};
    std::cout << (s2 - s1) << ' '
              << (i2 - i1) << ' '
              << (i1 - s1) << '\n';
}

Sortie : 

0 -1 -2

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 S'applique à Comportement publié Comportement corrigé
LWG 3574 C++20 variant était entièrement constexpr (P2231R1) mais common_iterator ne l'était pas également rendu constexpr

Voir aussi

avance l'itérateur common_iterator
(fonction membre publique)