std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::end, std::unordered_multiset<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_multiset.

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

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

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

Сложность

Постоянная.

Примечания

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

Пример

#include <iostream>
#include <iterator>
#include <string>
#include <unordered_set>

int main()
{
    const std::unordered_multiset<std::string> words =
    {
        "some", "words", "to", "count",
        "count", "these", "words"
    };

    for (auto it = words.begin(); it != words.end(); )
    {
        auto count = words.count(*it);
        std::cout << *it << ":\t" << count << '\n';
        std::advance(it, count); // all count elements have equivalent keys
    }
}

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

some:   1
words:  2
to:     1
count:  2
these:  1

См. также

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

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