std::multiset<Key,Compare,Allocator>::begin, std::multiset<Key,Compare,Allocator>::cbegin

iterator begin();	(1)	(noexcept начиная с C++11)
const_iterator begin() const;	(2)	(noexcept начиная с C++11)
const_iterator cbegin() const noexcept;	(3)	(начиная с C++11)

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

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

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

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

Сложность

Константная.

Примечания

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

libc++ переносит cbegin() в режим C++98.

Пример

#include <iostream>
#include <iterator>
#include <set>
#include <string>

int main()
{
    const std::multiset<std::string> words =
    {
        "some", "not", "sorted", "words",
        "will", "come", "out", "sorted",
    };

    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
    }
}

Вывод:

come:        1
not:        1
out:        1
some:        1
sorted:        2
will:        1
words:        1

См. также

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

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