std::multiset<Key,Compare,Allocator>:: end, std::multiset<Key,Compare,Allocator>:: cend

Gibt einen Iterator zurück, der hinter dem letzten Element von * this liegt.

Dieser zurückgegebene Iterator fungiert lediglich als Sentinel. Es ist nicht garantiert, dass er dereferenzierbar ist.

Rückgabewert

Iterator hinter dem letzten Element.

Komplexität

Konstante.

Hinweise

Da sowohl iterator als auch const_iterator konstante Iteratoren sind (und tatsächlich derselbe Typ sein können), ist es nicht möglich, die Elemente des Containers über einen von diesen Memberfunktionen zurückgegebenen Iterator zu verändern.

libc++ portiert cend() in den C++98-Modus zurück.

Beispiel

#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

Siehe auch