replace_if
Examine tous les éléments d'une plage et les remplace s'ils répondent à un prédicat spécifié.
template<class ForwardIterator, class Predicate, class Type>
void replace_if(
ForwardIterator _First,
ForwardIterator _Last,
Predicate _Pred,
const Type& _Val
);
Paramètres
_First
Un itérateur incrémentable qui pointe vers la position du premier élément dans la plage de laquelle les éléments sont remplacés._Last
Un itérateur qui pointe vers la position juste après l'élément final dans la plage depuis laquelle les éléments sont remplacés._Pred
L'attribut unitaire qui doit être satisfait est la valeur d'un élément qui doit être remplacé._Val
La nouvelle valeur assignée aux éléments dont l'ancienne valeur satisfont le prédicat.
Notes
La plage source triée référencée doit être valide ; tous les pointeurs doivent être deréférençables et, dans la séquence, la dernière position doit être accessible à partir de la première par incrémentation.
L'ordre des éléments non remplacés reste stable.
L'algorithme est une replace_if généralisation de l'algorithme replace, autorisant tout attribut à spécifier, au lieu de l'égalité à une valeur constante spécifiée.
L' operator== utilisé pour déterminer l'égalité entre les éléments doit appliquer une relation d'équivalence entre ses opérandes.
La complexité est linéaire : il existe _Last (–) _First comparaisons d'égalité et au plus _Last (–) _First attributions de nouvelles valeurs.
Exemple
// alg_replace_if.cpp
// compile with: /EHsc
#include <vector>
#include <algorithm>
#include <iostream>
bool greater6 ( int value ) {
return value >6;
}
int main( ) {
using namespace std;
vector <int> v1;
vector <int>::iterator Iter1;
int i;
for ( i = 0 ; i <= 9 ; i++ )
v1.push_back( i );
int ii;
for ( ii = 0 ; ii <= 3 ; ii++ )
v1.push_back( 7 );
random_shuffle ( v1.begin( ), v1.end( ) );
cout << "The original vector v1 is:\n ( " ;
for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
cout << *Iter1 << " ";
cout << ")." << endl;
// Replace elements satisfying the predicate greater6
// with a value of 70
replace_if ( v1.begin( ), v1.end( ), greater6 , 70);
cout << "The vector v1 with a value 70 replacing those\n "
<< "elements satisfying the greater6 predicate is:\n ( " ;
for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
cout << *Iter1 << " ";
cout << ")." << endl;
}
Résultat de l'exemple
The original vector v1 is:
( 7 1 9 2 0 7 7 3 4 6 8 5 7 7 ).
The vector v1 with a value 70 replacing those
elements satisfying the greater6 predicate is:
( 70 1 70 2 0 70 70 3 4 6 70 5 70 70 ).
Configuration requise
En-tête : <algorithme>
Espace de noms : std