<iterator>, operatory
operator!=
Sprawdza, czy obiekt iteratora po lewej stronie operatora nie jest równy obiektowi iteratora po prawej stronie.
template <class RandomIterator>
bool operator!=(const reverse_iterator<RandomIterator>& left, const reverse_iterator<RandomIterator>& right);
template <class Type, class CharType, class Traits, class Distance>
bool operator!=(const istream_iterator<Type, CharType, Traits, Distance>& left, const istream_iterator<Type, CharType, Traits, Distance>& right);
template <class CharType, class Tr>
bool operator!=(const istreambuf_iterator<CharType, Traits>& left, const istreambuf_iterator<CharType, Traits>& right);
Parametry
left
Obiekt typu iterator.
right
Obiekt typu iterator.
Wartość zwracana
true jeśli obiekty iteratora nie są równe; false jeśli obiekty iteratora są równe.
Uwagi
Jeden obiekt iteratora jest równy innemu, jeśli adresuje te same elementy w kontenerze. Jeśli dwa iteratory wskazują różne elementy w kontenerze, nie są równe.
Przykład
/// iterator_op_ne.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main()
{
using namespace std;
vector<int> vec;
for (int i = 1; i < 9; ++i)
{
vec.push_back(i);
}
cout << "The vector vec is: ( ";
for (vector <int>::iterator vIter = vec.begin(); vIter != vec.end(); vIter++)
{
cout << *vIter << " ";
}
cout << ")." << endl;
// Initializing reverse_iterators to the last element
vector <int>::reverse_iterator rVPOS1 = vec.rbegin(),
rVPOS2 = vec.rbegin();
cout << "The iterator rVPOS1 initially points to the first "
<< "element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
if (rVPOS1 != rVPOS2)
{
cout << "The iterators are not equal." << endl;
}
else
{
cout << "The iterators are equal." << endl;
}
rVPOS1++;
cout << "The iterator rVPOS1 now points to the second "
<< "element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
if (rVPOS1 != rVPOS2)
{
cout << "The iterators are not equal." << endl;
}
else
{
cout << "The iterators are equal." << endl;
}
}
The vector vec is: ( 1 2 3 4 5 6 7 8 ).
The iterator rVPOS1 initially points to the first element
in the reversed sequence: 8.
The iterators are equal.
The iterator rVPOS1 now points to the second element
in the reversed sequence: 7.
The iterators are not equal.
operator==
Testuje, czy obiekt iteratora po lewej stronie operatora jest równy obiektowi iteratora po prawej stronie.
template <class RandomIterator1, class RandomIterator2>
bool operator==(
const move_iterator<RandomIterator1>& left,
const move_iterator<RandomIterator2>& right);
template <class RandomIterator1, class RandomIterator2>
bool operator==(
const reverse_iterator<RandomIterator1>& left,
const reverse_iterator<RandomIterator2>& right);
template <class Type, class CharType, class Traits, class Distance>
bool operator==(
const istream_iterator<Type, CharType, Traits, Distance>& left,
const istream_iterator<Type, CharType, Traits, Distance>& right);
template <class CharType, class Tr>
bool operator==(
const istreambuf_iterator<CharType, Traits>& left,
const istreambuf_iterator<CharType, Traits>& right);
Parametry
left
Obiekt typu iterator.
right
Obiekt typu iterator.
Wartość zwracana
true jeśli obiekty iteratora są równe; false jeśli obiekty iteracyjne nie są równe.
Uwagi
Jeden obiekt iteratora jest równy innemu, jeśli adresuje te same elementy w kontenerze. Jeśli dwa iteratory wskazują różne elementy w kontenerze, nie są równe.
Dwa pierwsze operatory szablonów zwracają wartość true tylko wtedy, gdy obie left te same iteratory i right przechowują te same iteratory. Trzeci operator szablonu zwraca wartość true tylko wtedy, gdy zarówno, left jak i right przechowują ten sam wskaźnik strumienia. Czwarty operator szablonu zwraca wartość left.equal (right).
Przykład
// iterator_op_eq.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main()
{
using namespace std;
vector<int> vec;
for (int i = 1; i < 6; ++i)
{
vec.push_back(2 * i);
}
cout << "The vector vec is: ( ";
for (vector <int>::iterator vIter = vec.begin(); vIter != vec.end(); vIter++)
{
cout << *vIter << " ";
}
cout << ")." << endl;
// Initializing reverse_iterators to the last element
vector <int>::reverse_iterator rVPOS1 = vec.rbegin(),
rVPOS2 = vec.rbegin();
cout << "The iterator rVPOS1 initially points to the first "
<< "element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
if (rVPOS1 == rVPOS2)
{
cout << "The iterators are equal." << endl;
}
else
{
cout << "The iterators are not equal." << endl;
}
rVPOS1++;
cout << "The iterator rVPOS1 now points to the second "
<< "element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
if (rVPOS1 == rVPOS2)
{
cout << "The iterators are equal." << endl;
}
else
{
cout << "The iterators are not equal." << endl;
}
}
The vector vec is: ( 2 4 6 8 10 ).
The iterator rVPOS1 initially points to the first element
in the reversed sequence: 10.
The iterators are equal.
The iterator rVPOS1 now points to the second element
in the reversed sequence: 8.
The iterators are not equal.
operator<
Testuje, czy obiekt iteratora po lewej stronie operatora jest mniejszy niż obiekt iteratora po prawej stronie.
template <class RandomIterator>
bool operator<(const reverse_iterator<RandomIterator>& left, const reverse_iterator<RandomIterator>& right);
Parametry
left
Obiekt typu iterator.
right
Obiekt typu iterator.
Wartość zwracana
true jeśli iterator po lewej stronie wyrażenia jest mniejszy niż iterator po prawej stronie wyrażenia; false jeśli jest on większy lub równy iteratorowi po prawej stronie.
Uwagi
Jeden obiekt iteratora jest mniejszy niż inny, jeśli adresuje element, który występuje wcześniej w kontenerze niż element adresowany przez inny obiekt iteratora. Jeden obiekt iteratora nie jest mniejszy niż inny, jeśli adresuje ten sam element co drugi obiekt iteratora lub element, który występuje później w kontenerze niż element adresowany przez inny obiekt iteratora.
Przykład
// iterator_op_lt.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main()
{
using namespace std;
vector<int> vec;
for (int i = 0; i < 6; ++i)
{
vec.push_back(2 * i);
}
cout << "The initial vector vec is: ( ";
for (vector <int>::iterator vIter = vec.begin(); vIter != vec.end(); vIter++)
{
cout << *vIter << " ";
}
cout << ")." << endl;
// Initializing reverse_iterators to the last element
vector <int>::reverse_iterator rVPOS1 = vec.rbegin(),
rVPOS2 = vec.rbegin();
cout << "The iterators rVPOS1& rVPOS2 initially point to the "
<< "first element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
if (rVPOS1 < rVPOS2)
{
cout << "The iterator rVPOS1 is less than"
<< " the iterator rVPOS2." << endl;
}
else
{
cout << "The iterator rVPOS1 is not less than"
<< " the iterator rVPOS2." << endl;
rVPOS2++;
cout << "The iterator rVPOS2 now points to the second "
<< "element\n in the reversed sequence: "
<< *rVPOS2 << "." << endl;
if (rVPOS1 < rVPOS2)
{
cout << "The iterator rVPOS1 is less than"
<< " the iterator rVPOS2." << endl;
}
else
{
cout << "The iterator rVPOS1 is not less than"
<< " the iterator rVPOS2." << endl;
}
}
}
The initial vector vec is: ( 0 2 4 6 8 10 ).
The iterators rVPOS1& rVPOS2 initially point to the first element
in the reversed sequence: 10.
The iterator rVPOS1 is not less than the iterator rVPOS2.
The iterator rVPOS2 now points to the second element
in the reversed sequence: 8.
The iterator rVPOS1 is less than the iterator rVPOS2.
operator<=
Testuje, czy obiekt iteratora po lewej stronie operatora jest mniejszy niż lub równy obiektowi iteratora po prawej stronie.
template <class RandomIterator>
bool operator<=(const reverse_iterator<RandomIterator>& left, const reverse_iterator<RandomIterator>& right);
Parametry
left
Obiekt typu iterator.
right
Obiekt typu iterator.
Wartość zwracana
true jeśli iterator po lewej stronie wyrażenia jest mniejszy lub równy iteratorowi po prawej stronie wyrażenia; false jeśli jest większy niż iterator po prawej stronie.
Uwagi
Jeden obiekt iteratora jest mniejszy lub równy innemu, jeśli adresuje ten sam element lub element, który występuje wcześniej w kontenerze niż element adresowany przez inny obiekt iteratora. Jeden obiekt iteratora jest większy niż inny, jeśli adresuje element, który występuje później w kontenerze niż element adresowany przez inny obiekt iteratora.
Przykład
// iterator_op_le.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main()
{
using namespace std;
vector<int> vec;
for (int i = 0; i < 6; ++i)
{
vec.push_back(2 * i);
}
cout << "The initial vector vec is: ( ";
for (vector <int>::iterator vIter = vec.begin(); vIter != vec.end(); vIter++)
{
cout << *vIter << " ";
}
cout << ")." << endl;
vector <int>::reverse_iterator rVPOS1 = vec.rbegin() + 1,
rVPOS2 = vec.rbegin();
cout << "The iterator rVPOS1 initially points to the "
<< "second element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
cout << "The iterator rVPOS2 initially points to the "
<< "first element\n in the reversed sequence: "
<< *rVPOS2 << "." << endl;
if (rVPOS1 <= rVPOS2)
{
cout << "The iterator rVPOS1 is less than or "
<< "equal to the iterator rVPOS2." << endl;
}
else
{
cout << "The iterator rVPOS1 is greater than "
<< "the iterator rVPOS2." << endl;
}
rVPOS2++;
cout << "The iterator rVPOS2 now points to the second "
<< "element\n in the reversed sequence: "
<< *rVPOS2 << "." << endl;
if (rVPOS1 <= rVPOS2)
{
cout << "The iterator rVPOS1 is less than or "
<< "equal to the iterator rVPOS2." << endl;
}
else
{
cout << "The iterator rVPOS1 is greater than "
<< "the iterator rVPOS2." << endl;
}
}
The initial vector vec is: ( 0 2 4 6 8 10 ).
The iterator rVPOS1 initially points to the second element
in the reversed sequence: 8.
The iterator rVPOS2 initially points to the first element
in the reversed sequence: 10.
The iterator rVPOS1 is greater than the iterator rVPOS2.
The iterator rVPOS2 now points to the second element
in the reversed sequence: 8.
The iterator rVPOS1 is less than or equal to the iterator rVPOS2.
operator>
Testuje, czy obiekt iteratora po lewej stronie operatora jest większy niż obiekt iteratora po prawej stronie.
template <class RandomIterator>
bool operator>(const reverse_iterator<RandomIterator>& left, const reverse_iterator<RandomIterator>& right);
Parametry
left
Obiekt typu iterator.
right
Obiekt typu iterator.
Wartość zwracana
true jeśli iterator po lewej stronie wyrażenia jest większy niż iterator po prawej stronie wyrażenia; false jeśli jest mniejszy lub równy iteratorowi po prawej stronie.
Uwagi
Jeden obiekt iteratora jest większy niż inny, jeśli adresuje element, który występuje później w kontenerze niż element adresowany przez inny obiekt iteratora. Jeden obiekt iteratora nie jest większy niż inny, jeśli adresuje ten sam element co drugi obiekt iteratora lub element, który występuje wcześniej w kontenerze niż element adresowany przez inny obiekt iteratora.
Przykład
// iterator_op_gt.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main()
{
using namespace std;
vector<int> vec;
for (int i = 0; i < 6; ++i) {
vec.push_back(2 * i);
}
cout << "The initial vector vec is: ( ";
for (vector <int>::iterator vIter = vec.begin(); vIter != vec.end(); vIter++)
{
cout << *vIter << " ";
}
cout << ")." << endl;
vector <int>::reverse_iterator rVPOS1 = vec.rbegin(),
rVPOS2 = vec.rbegin();
cout << "The iterators rVPOS1 & rVPOS2 initially point to "
<< "the first element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
if (rVPOS1 > rVPOS2)
{
cout << "The iterator rVPOS1 is greater than "
<< "the iterator rVPOS2." << endl;
}
else
{
cout << "The iterator rVPOS1 is less than or "
<< "equal to the iterator rVPOS2." << endl;
}
rVPOS1++;
cout << "The iterator rVPOS1 now points to the second "
<< "element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
if (rVPOS1 > rVPOS2)
{
cout << "The iterator rVPOS1 is greater than "
<< "the iterator rVPOS2." << endl;
}
else
{
cout << "The iterator rVPOS1 is less than or "
<< "equal to the iterator rVPOS2." << endl;
}
}
The initial vector vec is: ( 0 2 4 6 8 10 ).
The iterators rVPOS1 & rVPOS2 initially point to the first element
in the reversed sequence: 10.
The iterator rVPOS1 is less than or equal to the iterator rVPOS2.
The iterator rVPOS1 now points to the second element
in the reversed sequence: 8.
The iterator rVPOS1 is greater than the iterator rVPOS2.
operator>=
Testuje, czy obiekt iteratora po lewej stronie operatora jest większy niż lub równy obiektowi iteratora po prawej stronie.
template <class RandomIterator>
bool operator>=(const reverse_iterator<RandomIterator>& left, const reverse_iterator<RandomIterator>& right);
Parametry
left
Obiekt typu iterator.
right
Obiekt typu iterator.
Wartość zwracana
true jeśli iterator po lewej stronie wyrażenia jest większy lub równy iteratorowi po prawej stronie wyrażenia; false jeśli jest mniejsza niż iterator po prawej stronie.
Uwagi
Jeden obiekt iteratora jest większy lub równy innemu, jeśli adresuje ten sam element lub element, który występuje później w kontenerze niż element adresowany przez inny obiekt iteratora. Jeden obiekt iteratora jest mniejszy niż inny, jeśli adresuje element, który występuje wcześniej w kontenerze niż element adresowany przez inny obiekt iteratora.
Przykład
// iterator_op_ge.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main()
{
using namespace std;
vector<int> vec;
for (int i = 0; i < 6; ++i)
{
vec.push_back(2 * i);
}
cout << "The initial vector vec is: ( ";
for (vector <int>::iterator vIter = vec.begin(); vIter != vec.end(); vIter++)
{
cout << *vIter << " ";
}
cout << ")." << endl;
vector <int>::reverse_iterator rVPOS1 = vec.rbegin(),
rVPOS2 = vec.rbegin() + 1;
cout << "The iterator rVPOS1 initially points to the "
<< "first element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
cout << "The iterator rVPOS2 initially points to the "
<< "second element\n in the reversed sequence: "
<< *rVPOS2 << "." << endl;
if (rVPOS1 >= rVPOS2)
{
cout << "The iterator rVPOS1 is greater than or "
<< "equal to the iterator rVPOS2." << endl;
}
else
{
cout << "The iterator rVPOS1 is less than "
<< "the iterator rVPOS2." << endl;
}
rVPOS1++;
cout << "The iterator rVPOS1 now points to the second "
<< "element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
if (rVPOS1 >= rVPOS2)
{
cout << "The iterator rVPOS1 is greater than or "
<< "equal to the iterator rVPOS2." << endl;
}
else
{
cout << "The iterator rVPOS1 is less than "
<< "the iterator rVPOS2." << endl;
}
}
The initial vector vec is: ( 0 2 4 6 8 10 ).
The iterator rVPOS1 initially points to the first element
in the reversed sequence: 10.
The iterator rVPOS2 initially points to the second element
in the reversed sequence: 8.
The iterator rVPOS1 is less than the iterator rVPOS2.
The iterator rVPOS1 now points to the second element
in the reversed sequence: 8.
The iterator rVPOS1 is greater than or equal to the iterator rVPOS2.
operator+
Dodaje przesunięcie do iteratora i zwraca move_iterator element lub reverse_iterator odnoszący się do wstawionego elementu w nowej pozycji przesunięcia.
template <class RandomIterator, class Diff>
move_iterator<RandomIterator>
operator+(
Diff _Off,
const move_iterator<RandomIterator>& right);
template <class RandomIterator>
reverse_iterator<RandomIterator>
operator+(
Diff _Off,
const reverse_iterator<RandomIterator>& right);
Parametry
Off
Liczba pozycji move_iterator const lub const reverse_iterator ma być przesunięty.
right
Iterator ma zostać przesunięty.
Wartość zwracana
Zwraca sumę right + Off.
Przykład
// iterator_op_insert.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main()
{
using namespace std;
vector<int> vec;
for (int i = 0; i < 6; ++i)
{
vec.push_back(2 * i);
}
cout << "The initial vector vec is: ( ";
for (vector <int>::iterator vIter = vec.begin(); vIter != vec.end(); vIter++)
{
cout << *vIter << " ";
}
cout << ")." << endl;
vector <int>::reverse_iterator rVPOS1 = vec.rbegin();
cout << "The iterator rVPOS1 initially points to "
<< "the first element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
vector<int>::difference_type diff = 4;
rVPOS1 = diff + rVPOS1;
cout << "The iterator rVPOS1 now points to the fifth "
<< "element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
}
The initial vector vec is: ( 0 2 4 6 8 10 ).
The iterator rVPOS1 initially points to the first element
in the reversed sequence: 10.
The iterator rVPOS1 now points to the fifth element
in the reversed sequence: 2.
operator-
Odejmuje jeden iterator od innego i zwraca różnicę.
template <class RandomIterator1, class RandomIterator2>
Tdiff operator-(
const move_iterator<RandomIterator1>& left,
const move_iterator<RandomIterator2>& right);
template <class RandomIterator1, class RandomIterator2>
Tdiff operator-(
const reverse_iterator<RandomIterator1>& left,
const reverse_iterator<RandomIterator2>& right);
Parametry
left
Iterację.
right
Iterację.
Wartość zwracana
Różnica między dwoma iteratorami.
Uwagi
Pierwszy operator szablonu zwraca wartość left.base() - right.base().
Drugi operator szablonu zwraca wartość right.current - left.current.
Tdiff jest określany przez typ zwracanego wyrażenia. W przeciwnym razie jest to RandomIterator1::difference_type.
Przykład
// iterator_op_sub.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>
int main()
{
using namespace std;
vector<int> vec;
for (int i = 0; i < 6; ++i)
{
vec.push_back(2 * i);
}
cout << "The initial vector vec is: ( ";
for (vector <int>::iterator vIter = vec.begin(); vIter != vec.end(); vIter++)
{
cout << *vIter << " ";
}
cout << ")." << endl;
vector <int>::reverse_iterator rVPOS1 = vec.rbegin(),
rVPOS2 = vec.rbegin();
cout << "The iterators rVPOS1 & rVPOS2 initially point to "
<< "the first element\n in the reversed sequence: "
<< *rVPOS1 << "." << endl;
for (int i = 1; i < 5; ++i)
{
rVPOS2++;
}
cout << "The iterator rVPOS2 now points to the fifth "
<< "element\n in the reversed sequence: "
<< *rVPOS2 << "." << endl;
vector<int>::difference_type diff = rVPOS2 - rVPOS1;
cout << "The difference: rVPOS2 - rVPOS1= "
<< diff << "." << endl;
}
The initial vector vec is: ( 0 2 4 6 8 10 ).
The iterators rVPOS1 & rVPOS2 initially point to the first element
in the reversed sequence: 10.
The iterator rVPOS2 now points to the fifth element
in the reversed sequence: 2.
The difference: rVPOS2 - rVPOS1= 4.
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla