remove_copy
複製來源範圍的項目到目的範圍,不過,一個指定值的項目不會複製,不會干擾其他項目的順序和傳回新的目的範圍的結尾。
template<class InputIterator, class OutputIterator, class Type>
OutputIterator remove_copy(
InputIterator _First,
InputIterator _Last,
OutputIterator _Result,
const Type& _Val
);
參數
_First
輸入定址的 Iterator 第一個項目的位置移除項目的範圍。_Last
輸入定址的 Iterator 將最後一個項目的位置可在項目移除的範圍。_Result
輸出定址的 Iterator 的第一個項目位置在項目移除的目的範圍。_Val
要從這個範圍中移除的值。
傳回值
解決向前的 Iterator 目的範圍的新結束位置,一個傳遞剩餘序列的複本的最後一個項目沒有指定值。
備註
參考的來源和目的範圍必須是有效的;所有指標必須 dereferenceable,並在序列中最後一個位置從開始取用的增量。
必須在包含要複製的剩餘的項目之範圍的足夠的空間,以移除後指定值的項目。
無法移除之項目的順序維持穩定狀態。
operator== 可用來判斷項目之間的相等必須安排在其運算元之間的等價關聯。
複雜的屬性;有 (_Last – _First) 相等比較至多 (_Last – _First) 指派。
remove_copy 有兩個相關表單:
如需這些函式之行為的詳細資訊,請參閱已檢查的迭代器。
範例
// alg_remove_copy.cpp
// compile with: /EHsc
#include <vector>
#include <algorithm>
#include <iostream>
int main() {
using namespace std;
vector <int> v1, v2(10);
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 << "The original 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_copy ( v1.begin( ), v1.end( ), v2.begin( ), 7 );
cout << "Vector v1 is left unchanged as ( " ;
for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
cout << *Iter1 << " ";
cout << ")." << endl;
cout << "Vector v2 is a copy of v1 with the value 7 removed:\n ( " ;
for ( Iter2 = v2.begin( ) ; Iter2 != v2.end( ) ; Iter2++ )
cout << *Iter2 << " ";
cout << ")." << endl;
}
範例輸出
The original vector v1 is: ( 7 1 9 2 0 7 7 3 4 6 8 5 7 7 ).
Vector v1 is left unchanged as ( 7 1 9 2 0 7 7 3 4 6 8 5 7 7 ).
Vector v2 is a copy of v1 with the value 7 removed:
( 1 9 2 0 3 4 6 8 5 0 ).
需求
標頭:<algorithm>
命名空間: std