remove
Elimina um valor de um determinado intervalo especificado sem perturbar a ordem dos elementos restantes e retornar ao final de um novo espaço livre do valor especificado.
template<class ForwardIterator, class Type>
ForwardIterator remove(
ForwardIterator _First,
ForwardIterator _Last,
const Type& _Val
);
Parâmetros
_First
Um iterador frente que trata a posição do primeiro elemento no intervalo de elementos que estão sendo removidos._Last
Um iterador frente que trata a posição uma após o elemento final no intervalo de elementos que estão sendo removidos._Val
O valor que deve ser removido do intervalo.
Valor de retorno
Um iterador frente que trata a nova posição de início do intervalo alterado, uma após o elemento final da seqüência do resto livre de valor especificado.
Comentários
o intervalo referenciado deve ser válido; todos os ponteiros devem ser dereferenceable e na seqüência a posição da última é alcançável de primeira por incrementação.
A ordem dos elementos não removidos permanece estável.
operator== usado para determinar igualdade entre elementos deve impor uma relação de equivalência entre os operandos.
Complexidade é linear; há_Last (–) _Firstas comparações de igualdade.
A classe de lista tem uma versão mais eficiente da função de membro de remove, que também relinks ponteiros.
Exemplo
// alg_remove.cpp
// compile with: /EHsc
#include <vector>
#include <algorithm>
#include <iostream>
int main( ) {
using namespace std;
vector <int> v1;
vector <int>::iterator Iter1, Iter2, new_end;
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 << "Vector v1 is ( " ;
for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
cout << *Iter1 << " ";
cout << ")." << endl;
// Remove elements with a value of 7
new_end = remove ( v1.begin( ), v1.end( ), 7 );
cout << "Vector v1 with value 7 removed is ( " ;
for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
cout << *Iter1 << " ";
cout << ")." << endl;
// To change the sequence size, use erase
v1.erase (new_end, v1.end( ) );
cout << "Vector v1 resized with value 7 removed is ( " ;
for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
cout << *Iter1 << " ";
cout << ")." << endl;
}
A saída de exemplo
Vector v1 is ( 7 1 9 2 0 7 7 3 4 6 8 5 7 7 ).
Vector v1 with value 7 removed is ( 1 9 2 0 3 4 6 8 5 6 8 5 7 7 ).
Vector v1 resized with value 7 removed is ( 1 9 2 0 3 4 6 8 5 ).
Requisitos
Cabeçalho: <algorithm>
namespace: STD