Compartir a través de


hash_map::begin (STL/CLR)

Designates the beginning of the controlled sequence.

    iterator begin();

Remarks

The member function returns a bidirectional iterator that designates the first element of the controlled sequence, or just beyond the end of an empty sequence. You use it to obtain an iterator that designates the current beginning of the controlled sequence, but its status can change if the length of the controlled sequence changes.

Example

// cliext_hash_map_begin.cpp 
// compile with: /clr 
#include <cliext/hash_map> 
 
typedef cliext::hash_map<wchar_t, int> Myhash_map; 
int main() 
    { 
    Myhash_map c1; 
    c1.insert(Myhash_map::make_value(L'a', 1)); 
    c1.insert(Myhash_map::make_value(L'b', 2)); 
    c1.insert(Myhash_map::make_value(L'c', 3)); 
 
// display contents " [a 1] [b 2] [c 3]" 
    for each (Myhash_map::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
// inspect first two items 
    Myhash_map::iterator it = c1.begin(); 
    System::Console::WriteLine("*begin() = [{0} {1}]", 
        it->first, it->second); 
    ++it; 
    System::Console::WriteLine("*++begin() = [{0} {1}]", 
        it->first, it->second); 
    return (0); 
    } 
 
 [a 1] [b 2] [c 3]
*begin() = [a 1]
*++begin() = [b 2]

Requirements

Header: <cliext/hash_map>

Namespace: cliext

See Also

Concepts

hash_map (STL/CLR)

hash_map::end (STL/CLR)