std::unordered_set<Key,Hash,KeyEqual,Allocator>::end, std::unordered_set<Key,Hash,KeyEqual,Allocator>::cend

iterator end() noexcept;	(1)	(с C++11)
const_iterator end() const noexcept;	(2)	(с C++11)
const_iterator cend() const noexcept;	(3)	(с C++11)

Возвращает итератор на элемент, следующий за последним элементом unordered_set.

Этот элемент используется как маркер; попытка доступа к нему приводит к неопределённому поведению.

Параметры

(нет)

Возвращаемое значение

Итератор на элемент, следующий за последним элементом.

Сложность

Постоянная.

Примечания

Поскольку оба iterator и const_iterator являются константными итераторами (и, возможно, имеют один и тот же тип), нельзя изменить элементы контейнера с помощью итератора, возвращаемого любой из этих функций-членов.

Пример

#include <iostream>
#include <unordered_set>
 
struct Point { double x, y; };
 
int main()
{
    Point pts[3] = {{1, 0}, {2, 0}, {3, 0}};
 
    // points is a set containing the addresses of points
    std::unordered_set<Point*> points = { pts, pts + 1, pts + 2 };
 
    // Change each y-coordinate of (i, 0) from 0 into i^2 and print the point
    for (auto iter = points.begin(); iter != points.end(); ++iter)
    {
        (*iter)->y = ((*iter)->x) * ((*iter)->x); // iter is a pointer-to-Point*
        std::cout << "(" << (*iter)->x << ", " << (*iter)->y << ") ";
    }
    std::cout << '\n';
 
    // Now using the range-based for loop, we increase each y-coordinate by 10
    for (Point* i : points)
    {
        i->y += 10;
        std::cout << "(" << i->x << ", " << i->y << ") ";
    }
}

Возможный вывод:

(3, 9) (1, 1) (2, 4) 
(3, 19) (1, 11) (2, 14)

См. также

begincbegin	возвращает итератор на начало (публичная функция-член)
endcend (C++11)(C++14)	возвращает итератор на конец контейнера или массива (шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/unordered_set/end