std::unordered_set<Key,Hash,KeyEqual,Allocator>::begin, std::unordered_set<Key,Hash,KeyEqual,Allocator>::cbegin

iterator begin() noexcept;	(1)	(since C++11)
const_iterator begin() const noexcept;	(2)	(since C++11)
const_iterator cbegin() const noexcept;	(3)	(since C++11)

Возвращает итератор на первый элемент unordered_set.

Если unordered_set пуста, возвращаемый итератор будет равен end().

Параметры

(нет)

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

Итератор на первый элемент.

Сложность

Постоянная.

Примечания

Поскольку оба 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)

См. также

endcend	возвращает итератор на конец (публичная функция-член)
begincbegin (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/begin