Share via


unordered_multiset::begin

Designates the beginning of the controlled sequence or a bucket.

iterator begin();
    const_iterator begin() const;
    local_iterator begin(size_type nbucket);
    const_local_iterator begin(size_type nbucket) const;

Parameters

  • nbucket
    The bucket number.

Remarks

The first two member functions return a forward iterator that points at the first element of the sequence (or just beyond the end of an empty sequence). The last two member functions return a forward iterator that points at the first element of bucket nbucket (or just beyond the end of an empty bucket).

Example

 

// std_tr1__unordered_set__unordered_multiset_begin.cpp 
// compile with: /EHsc 
#include <unordered_set> 
#include <iostream> 
 
typedef std::tr1::unordered_multiset<char> Myset; 
int main() 
    { 
    Myset c1; 
 
    c1.insert('a'); 
    c1.insert('b'); 
    c1.insert('c'); 
 
// display contents " [c] [b] [a]" 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// inspect first two items " [c] [b]" 
    Myset::iterator it2 = c1.begin(); 
    std::cout << " [" << *it2 << "]"; 
    ++it2; 
    std::cout << " [" << *it2 << "]"; 
    std::cout << std::endl; 
 
// inspect bucket containing 'a' 
    Myset::const_local_iterator lit = c1.begin(c1.bucket('a')); 
    std::cout << " [" << *lit << "]"; 
 
    return (0); 
    } 
 

[c] [b] [a] [c] [b] [a]

Requirements

Header: <unordered_set>

Namespace: std::tr1

See Also

Reference

<unordered_set>

unordered_multiset Class

unordered_multiset::end