multimap::rbegin (STL/CLR)

Designates the beginning of the reversed controlled sequence.

    reverse_iterator rbegin();

Remarks

The member function returns a reverse iterator that designates the last element of the controlled sequence, or just beyond the beginning of an empty sequence. Hence, it designates the beginning of the reverse sequence. You use it to obtain an iterator that designates the current beginning of the controlled sequence seen in reverse order, but its status can change if the length of the controlled sequence changes.

Example

// cliext_multimap_rbegin.cpp 
// compile with: /clr 
#include <cliext/map> 
 
typedef cliext::multimap<wchar_t, int> Mymultimap; 
int main() 
    { 
    Mymultimap c1; 
    c1.insert(Mymultimap::make_value(L'a', 1)); 
    c1.insert(Mymultimap::make_value(L'b', 2)); 
    c1.insert(Mymultimap::make_value(L'c', 3)); 
 
// display contents " [a 1] [b 2] [c 3]" 
    for each (Mymultimap::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
// inspect first two items in reversed sequence 
    Mymultimap::reverse_iterator rit = c1.rbegin(); 
    System::Console::WriteLine("*rbegin() = [{0} {1}]", 
        rit->first, rit->second); 
    ++rit; 
    System::Console::WriteLine("*++rbegin() = [{0} {1}]", 
        rit->first, rit->second); 
    return (0); 
    } 
 
 [a 1] [b 2] [c 3]
*rbegin() = [c 3]
*++rbegin() = [b 2]

Requirements

Header: <cliext/map>

Namespace: cliext

See Also

Concepts

multimap (STL/CLR)

multimap::begin (STL/CLR)

multimap::end (STL/CLR)

multimap::rend (STL/CLR)