std:: mismatch
|
Definiert im Header
<algorithm>
|
||
|
template
<
class
InputIt1,
class
InputIt2
>
std::
pair
<
InputIt1, InputIt2
>
|
(1) | (constexpr seit C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2
>
std::
pair
<
ForwardIt1, ForwardIt2
>
|
(2) | (seit C++17) |
|
template
<
class
InputIt1,
class
InputIt2,
class
BinaryPred
>
std::
pair
<
InputIt1, InputIt2
>
|
(3) | (constexpr seit C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2,
class
BinaryPred
>
|
(4) | (seit C++17) |
|
template
<
class
InputIt1,
class
InputIt2
>
std::
pair
<
InputIt1, InputIt2
>
|
(5) |
(seit C++14)
(constexpr seit C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2
>
std::
pair
<
ForwardIt1, ForwardIt2
>
|
(6) | (seit C++17) |
|
template
<
class
InputIt1,
class
InputIt2,
class
BinaryPred
>
std::
pair
<
InputIt1, InputIt2
>
|
(7) |
(seit C++14)
(constexpr seit C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2,
class
BinaryPred
>
|
(8) | (seit C++17) |
Gibt ein Paar von Iteratoren zum ersten nicht übereinstimmenden Element aus
[
first1
,
last1
)
und einem Bereich beginnend bei
first2
zurück:
- Für Überladungen (1-4) hat der zweite Bereich std:: distance ( first1, last1 ) Elemente.
-
Für Überladungen
(5-8)
ist der zweite Bereich
[first2,last2).
-
- Falls std:: distance ( first1, last1 ) und std:: distance ( first2, last2 ) unterschiedlich sind, bricht der Vergleich ab, wenn last1 oder last2 erreicht wird.
|
std:: is_execution_policy_v < std:: decay_t < ExecutionPolicy >> ist true . |
(bis C++20) |
|
std:: is_execution_policy_v < std:: remove_cvref_t < ExecutionPolicy >> ist true . |
(seit C++20) |
Inhaltsverzeichnis |
Parameter
| first1, last1 | - | das Iteratorpaar, das den ersten Bereich der zu vergleichenden Elemente definiert |
| first2, last2 | - | das Iteratorpaar, das den zweiten Bereich der zu vergleichenden Elemente definiert |
| policy | - | die zu verwendende Ausführungsrichtlinie |
| p | - |
binäres Prädikat, das
true
zurückgibt, wenn die Elemente als gleich behandelt werden sollen.
Die Signatur der Prädikatfunktion sollte äquivalent zu Folgendem sein: bool pred ( const Type1 & a, const Type2 & b ) ;
Obwohl die Signatur nicht
const
&
benötigt, darf die Funktion die übergebenen Objekte nicht modifizieren und muss alle Werte der Typen (möglicherweise const)
|
| Typanforderungen | ||
-
InputIt1
muss die Anforderungen von
LegacyInputIterator
erfüllen.
|
||
-
InputIt2
muss die Anforderungen von
LegacyInputIterator
erfüllen.
|
||
-
ForwardIt1
muss die Anforderungen von
LegacyForwardIterator
erfüllen.
|
||
-
ForwardIt2
muss die Anforderungen von
LegacyForwardIterator
erfüllen.
|
||
-
BinaryPred
muss die Anforderungen von
BinaryPredicate
erfüllen.
|
||
Rückgabewert
std::pair mit Iteratoren zu den ersten beiden ungleichen Elementen.
Wenn last1 erreicht wird, ist der zweite Iterator im Paar der std:: distance ( first1, last1 ) te Iterator nach first2 .
Für Überladungen (5-8) , falls last2 erreicht wird, ist der erste Iterator im Paar der std:: distance ( first2, last2 ) te Iterator nach first1 .
Komplexität
Gegeben N 1 als std:: distance ( first1, last1 ) und N 2 als std:: distance ( first2, last2 ) :
Ausnahmen
Die Überladungen mit einem Template-Parameter namens
ExecutionPolicy
melden Fehler wie folgt:
-
Wenn die Ausführung einer als Teil des Algorithmus aufgerufenen Funktion eine Exception wirft und
ExecutionPolicyeiner der Standard-Policies ist, wird std::terminate aufgerufen. Für jede andereExecutionPolicyist das Verhalten implementierungsdefiniert. - Wenn der Algorithmus keinen Speicher allozieren kann, wird std::bad_alloc geworfen.
Mögliche Implementierung
| mismatch (1) |
|---|
template<class InputIt1, class InputIt2> std::pair<InputIt1, InputIt2> mismatch(InputIt1 first1, InputIt1 last1, InputIt2 first2) { while (first1 != last1 && *first1 == *first2) ++first1, ++first2; return std::make_pair(first1, first2); } |
| mismatch (3) |
template<class InputIt1, class InputIt2, class BinaryPred> std::pair<InputIt1, InputIt2> mismatch(InputIt1 first1, InputIt1 last1, InputIt2 first2, BinaryPred p) { while (first1 != last1 && p(*first1, *first2)) ++first1, ++first2; return std::make_pair(first1, first2); } |
| mismatch (5) |
template<class InputIt1, class InputIt2> std::pair<InputIt1, InputIt2> mismatch(InputIt1 first1, InputIt1 last1, InputIt2 first2, InputIt2 last2) { while (first1 != last1 && first2 != last2 && *first1 == *first2) ++first1, ++first2; return std::make_pair(first1, first2); } |
| mismatch (7) |
template<class InputIt1, class InputIt2, class BinaryPred> std::pair<InputIt1, InputIt2> mismatch(InputIt1 first1, InputIt1 last1, InputIt2 first2, InputIt2 last2, BinaryPred p) { while (first1 != last1 && first2 != last2 && p(*first1, *first2)) ++first1, ++first2; return std::make_pair(first1, first2); } |
Beispiel
Dieses Programm ermittelt den längsten Teilstring, der gleichzeitig am Anfang der gegebenen Zeichenkette und am Ende davon in umgekehrter Reihenfolge (möglicherweise überlappend) vorkommt.
#include <algorithm> #include <iostream> #include <string> std::string mirror_ends(const std::string& in) { return std::string(in.begin(), std::mismatch(in.begin(), in.end(), in.rbegin()).first); } int main() { std::cout << mirror_ends("abXYZba") << '\n' << mirror_ends("abca") << '\n' << mirror_ends("aba") << '\n'; }
Ausgabe:
ab a aba
Siehe auch
|
bestimmt, ob zwei Elementgruppen identisch sind
(Funktions-Template) |
|
|
(C++11)
|
findet das erste Element, das bestimmte Kriterien erfüllt
(Funktions-Template) |
|
gibt
true
zurück, falls ein Bereich lexikographisch kleiner als ein anderer ist
(Funktions-Template) |
|
|
sucht nach dem ersten Vorkommen eines Elementbereichs
(Funktions-Template) |
|
|
(C++20)
|
findet die erste Position, an der sich zwei Bereiche unterscheiden
(Algorithmus-Funktionsobjekt) |