std::ranges::mismatch, std::ranges::mismatch_result
| Definiert in Header <algorithm>
|
||
| Aufrufsignatur |
||
template< std::input_iterator I1, std::sentinel_for<I1> S1,
std::input_iterator I2, std::sentinel_for<I2> S2,
class Pred = ranges::equal_to,
class Proj1 = std::identity, class Proj2 = std::identity >
requires std::indirectly_comparable<I1, I2, Pred, Proj1, Proj2>
constexpr mismatch_result<I1, I2>
mismatch( I1 first1, S1 last1, I2 first2, S2 last2,
Pred pred = {}, Proj1 proj1 = {}, Proj2 proj2 = {} );
|
(1) | (seit C++20) |
template< ranges::input_range R1, ranges::input_range R2,
class Pred = ranges::equal_to,
class Proj1 = std::identity, class Proj2 = std::identity >
requires std::indirectly_comparable<
ranges::iterator_t<R1>, ranges::iterator_t<R2>, Pred, Proj1, Proj2>
constexpr mismatch_result<ranges::borrowed_iterator_t<R1>,
ranges::borrowed_iterator_t<R2>>
mismatch( R1&& r1, R2&& r2, Pred pred = {},
Proj1 proj1 = {}, Proj2 proj2 = {} );
|
(2) | (seit C++20) |
| Hilfstypen |
||
template< class I1, class I2 >
using mismatch_result = ranges::in_in_result<I1, I2>;
|
(3) | (seit C++20) |
Gibt das erste nicht übereinstimmende Paar von projizierten Elementen aus zwei Bereichen zurück: eines definiert durch [first1, last1) oder r1 und ein weiteres definiert durch [first2, last2) oder r2.
p.r als Quellbereich, als ob ranges::begin(r) als first und ranges::end(r) als last verwendet würden.Die auf dieser Seite beschriebenen funktionsähnlichen Entitäten sind Algorithmus-Funktionsobjekte (informell als Niebloids bekannt), das heißt:
- Explizite Vorlagenargumentlisten können beim Aufruf von keiner von ihnen angegeben werden.
- Keine von ihnen ist für argumentabhängige Suche sichtbar.
- Wenn eine von ihnen durch normale unqualifizierte Suche als Name links vom Funktionsaufrufoperator gefunden wird, wird die argumentabhängige Suche unterbunden.
Parameter
| first1, last1 | - | das Iterator-Sentinel-Paar, das den ersten Bereich der zu vergleichenden Elemente definiert |
| r1 | - | der erste Bereich der zu vergleichenden Elemente |
| first2, last2 | - | das Iterator-Sentinel-Paar, das den zweiten Bereich der zu vergleichenden Elemente definiert |
| r2 | - | der zweite Bereich der zu vergleichenden Elemente |
| pred | - | Prädikat, das auf die projizierten Elemente angewendet wird |
| proj1 | - | Projektion, die auf den ersten Elementbereich angewendet wird |
| proj2 | - | Projektion, die auf den zweiten Elementbereich angewendet wird |
Rückgabewert
ranges::mismatch_result
mit Iteratoren zu den ersten beiden ungleichen Elementen.
Wenn beim Vergleich keine Nichtübereinstimmungen gefunden werden, bis last1 oder last2 erreicht wird, je nachdem was zuerst eintritt, enthält das Objekt den End-Iterator und den entsprechenden Iterator aus dem anderen Bereich.
Komplexität
Höchstens std:: min ( last1 - first1, last2 - first2 ) Anwendungen des Prädikats und entsprechender Projektionen.
Mögliche Implementierung
struct mismatch_fn { template<std::input_iterator I1, std::sentinel_for<I1> S1, std::input_iterator I2, std::sentinel_for<I2> S2, class Pred = ranges::equal_to, class Proj1 = std::identity, class Proj2 = std::identity> requires std::indirectly_comparable<I1, I2, Pred, Proj1, Proj2> constexpr std::mismatch_result<I1, I2> operator()(I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = {}, Proj1 proj1 = {}, Proj2 proj2 = {}) const { for (; first1 != last1 && first2 != last2; ++first1, (void)++first2) if (not std::invoke(pred, std::invoke(proj1, *first1), std::invoke(proj2, *first2))) break; return {first1, first2}; } template<ranges::input_range R1, ranges::input_range R2, class Pred = ranges::equal_to, class Proj1 = std::identity, class Proj2 = std::identity> requires std::indirectly_comparable<ranges::iterator_t<R1>, ranges::iterator_t<R2>, Pred, Proj1, Proj2> constexpr ranges::mismatch_result<ranges::borrowed_iterator_t<R1>, ranges::borrowed_iterator_t<R2>> operator()(R1&& r1, R2&& r2, Pred pred = {}, Proj1 proj1 = {}, Proj2 proj2 = {}) const { return (*this)(ranges::begin(r1), ranges::end(r1), ranges::begin(r2), ranges::end(r2), std::ref(pred), std::ref(proj1), std::ref(proj2)); } }; inline constexpr mismatch_fn mismatch; |
Beispiel
Dieses Programm bestimmt den längsten Teilstring, der gleichzeitig am Anfang und am Ende der gegebenen Zeichenkette in umgekehrter Reihenfolge gefunden wird (möglicherweise überlappend).
#include <algorithm> #include <iostream> #include <ranges> #include <string_view> [[nodiscard]] constexpr std::string_view mirror_ends(const std::string_view in) { const auto end = std::ranges::mismatch(in, in | std::views::reverse).in1; return {in.cbegin(), end}; } int main() { std::cout << mirror_ends("abXYZba") << '\n' << mirror_ends("abca") << '\n' << mirror_ends("ABBA") << '\n' << mirror_ends("level") << '\n'; using namespace std::literals::string_view_literals; static_assert("123"sv == mirror_ends("123!@#321")); static_assert("radar"sv == mirror_ends("radar")); }
Ausgabe:
ab a ABBA level
Siehe auch
(C++20) |
ermittelt, ob zwei Mengen von Elementen gleich sind (Algorithmusfunktionsobjekt) |
(C++20)(C++20)(C++20) |
findet das erste Element, das bestimmte Kriterien erfüllt (Algorithmusfunktionsobjekt) |
| vergleicht zwei Bereiche lexikografisch (Algorithmusfunktionsobjekt) | |
(C++20) |
sucht nach dem ersten Vorkommen eines Bereichs von Elementen (Algorithmusfunktionsobjekt) |
| findet die erste Position, an der sich zwei Bereiche unterscheiden (Funktionsschablone) |