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 >

erfordert 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 ) ;
(seit C++20)

Berechnet den Abstand zwischen zwei Iterator-Adaptoren. Zwei Sentinel-Werte werden als gleich betrachtet.

Sei var das zugrundeliegende std::variant -Mitgliedsobjekt in std::common_iterator , dann ist das Verhalten undefiniert, falls entweder x oder y ungültig ist, d.h. x. var . valueless_by_exception ( ) || y. var . valueless_by_exception ( ) gleich true ist.

Diese Funktionsvorlage ist für gewöhnliches unqualified oder qualified lookup nicht sichtbar und kann nur durch argument-dependent lookup gefunden werden, wenn std::common_iterator<I> eine assoziierte Klasse der Argumente ist.

Inhaltsverzeichnis

Parameter

x, y - Iterator-Adapter zur Berechnung der Differenz von

Rückgabewert

  • ​ 0 ​ wenn x. var ein S -Objekt enthält und y. var ein S2 -Objekt enthält, d.h. beide einen Sentinel halten.
  • Andernfalls, alt_x - alt_y , wobei alt_x und alt_y die von x. var und y. var gehaltenen Alternativen sind (entweder zwei Iteratoren oder ein Iterator und ein Sentinel).

Beispiel

Diesen Code ausführen 
#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';
}

Ausgabe: 

0 -1 -2

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 3574 C++20 variant war vollständig constexpr (P2231R1) aber common_iterator war es nicht ebenfalls constexpr gemacht

Siehe auch

bewegt den common_iterator vorwärts
(öffentliche Elementfunktion)