list::begin

list::begin (STL/CLR)

 

Designates the beginning of the controlled sequence.

iterator begin();

The member function returns a random-access 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_list_begin.cpp 
// compile with: /clr 
#include <cliext/list> 

int main() 
    { 
    cliext::list<wchar_t> c1; 
    c1.push_back(L'a'); 
    c1.push_back(L'b'); 
    c1.push_back(L'c'); 

// display initial contents " a b c" 
    for each (wchar_t elem in c1) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 

// inspect first two items 
    cliext::list<wchar_t>::iterator it = c1.begin(); 
    System::Console::WriteLine("*begin() = {0}", *it); 
    System::Console::WriteLine("*++begin() = {0}", *++it); 

// alter first two items and reinspect 
    *--it = L'x'; 
    *++it = L'y'; 
    for each (wchar_t elem in c1) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
    return (0); 
    } 

 a b c
*begin() = a
*++begin() = b
 x y c

Requirements

Header: <cliext/list>

Namespace: cliext

Show:
© 2016 Microsoft