std:: mismatch
|
Défini dans l'en-tête
<algorithm>
|
||
|
template
<
class
InputIt1,
class
InputIt2
>
std::
pair
<
InputIt1, InputIt2
>
|
(1) | (constexpr depuis C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2
>
std::
pair
<
ForwardIt1, ForwardIt2
>
|
(2) | (depuis C++17) |
|
template
<
class
InputIt1,
class
InputIt2,
class
BinaryPred
>
std::
pair
<
InputIt1, InputIt2
>
|
(3) | (constexpr depuis C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2,
class
BinaryPred
>
|
(4) | (depuis C++17) |
|
template
<
class
InputIt1,
class
InputIt2
>
std::
pair
<
InputIt1, InputIt2
>
|
(5) |
(depuis C++14)
(constexpr depuis C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2
>
std::
pair
<
ForwardIt1, ForwardIt2
>
|
(6) | (depuis C++17) |
|
template
<
class
InputIt1,
class
InputIt2,
class
BinaryPred
>
std::
pair
<
InputIt1, InputIt2
>
|
(7) |
(depuis C++14)
(constexpr depuis C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2,
class
BinaryPred
>
|
(8) | (depuis C++17) |
Retourne une paire d'itérateurs vers le premier élément discordant entre
[
first1
,
last1
)
et une plage commençant à
first2
:
- Pour les surcharges (1-4) , la deuxième plage possède std:: distance ( first1, last1 ) éléments.
-
Pour les surcharges
(5-8)
, la deuxième plage est
[first2,last2).
-
- Si std:: distance ( first1, last1 ) et std:: distance ( first2, last2 ) sont différents, la comparaison s'arrête lorsque last1 ou last2 est atteint.
|
std:: is_execution_policy_v < std:: decay_t < ExecutionPolicy >> est true . |
(jusqu'à C++20) |
|
std:: is_execution_policy_v < std:: remove_cvref_t < ExecutionPolicy >> est true . |
(depuis C++20) |
Table des matières |
Paramètres
| first1, last1 | - | la paire d'itérateurs définissant la première plage d'éléments à comparer |
| first2, last2 | - | la paire d'itérateurs définissant la seconde plage d'éléments à comparer |
| policy | - | la politique d'exécution à utiliser |
| p | - |
prédicat binaire qui renvoie
true
si les éléments doivent être traités comme égaux.
La signature de la fonction de prédicat doit être équivalente à ce qui suit : bool pred ( const Type1 & a, const Type2 & b ) ;
Bien que la signature n'ait pas besoin d'avoir
const
&
, la fonction ne doit pas modifier les objets qui lui sont passés et doit pouvoir accepter toutes les valeurs du type (éventuellement const)
|
| Exigences de type | ||
-
InputIt1
doit satisfaire aux exigences de
LegacyInputIterator
.
|
||
-
InputIt2
doit satisfaire aux exigences de
LegacyInputIterator
.
|
||
-
ForwardIt1
doit satisfaire aux exigences de
LegacyForwardIterator
.
|
||
-
ForwardIt2
doit satisfaire aux exigences de
LegacyForwardIterator
.
|
||
-
BinaryPred
doit satisfaire aux exigences de
BinaryPredicate
.
|
||
Valeur de retour
std::pair avec des itérateurs vers les deux premiers éléments non égaux.
Si last1 est atteint, le deuxième itérateur de la paire est le std:: distance ( first1, last1 ) ème itérateur après first2 .
Pour les surcharges (5-8) , si last2 est atteint, le premier itérateur dans la paire est le std:: distance ( first2, last2 ) ème itérateur après first1 .
Complexité
Soit N 1 défini comme std:: distance ( first1, last1 ) et N 2 défini comme std:: distance ( first2, last2 ) :
Exceptions
Les surcharges avec un paramètre de modèle nommé
ExecutionPolicy
signalent les erreurs comme suit :
-
Si l'exécution d'une fonction invoquée dans le cadre de l'algorithme lève une exception et que
ExecutionPolicyfait partie des politiques standard , std::terminate est appelé. Pour tout autreExecutionPolicy, le comportement est défini par l'implémentation. - Si l'algorithme ne parvient pas à allouer de la mémoire, std::bad_alloc est levé.
Implémentation possible
| 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); } |
Exemple
Ce programme détermine la plus longue sous-chaîne qui se trouve simultanément au tout début de la chaîne donnée et à la toute fin de celle-ci, dans l'ordre inverse (avec un éventuel chevauchement).
#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'; }
Sortie :
ab a aba
Voir aussi
|
détermine si deux ensembles d'éléments sont identiques
(modèle de fonction) |
|
|
(C++11)
|
trouve le premier élément satisfaisant des critères spécifiques
(modèle de fonction) |
|
renvoie
true
si une plage est lexicographiquement inférieure à une autre
(modèle de fonction) |
|
|
recherche la première occurrence d'une plage d'éléments
(modèle de fonction) |
|
|
(C++20)
|
trouve la première position où deux plages diffèrent
(objet fonction algorithme) |