std::begin, std::cbegin

template< class C > 
auto begin( C& c ) -> decltype(c.begin());

template< class C > 
auto begin( const C& c ) -> decltype(c.begin());

template< class T, std::size_t N > 
T* begin( T (&array)[N] );

template< class C > 
constexpr auto cbegin( const C& c ) noexcept(/* see below */)
    -> decltype(std::begin(c));

Возвращает итератор на начало заданного диапазона.

Параметры

Возвращаемое значение

Исключения

Перегрузки

Пользовательские перегрузки begin могут быть предоставлены для классов и перечислений, которые не предоставляют подходящую функцию-член begin() , но по которым можно выполнять итерацию. Следующие перегрузки уже предоставлены стандартной библиотекой:

Подобно использованию swap (описанному в Swappable ), типичное использование функции begin в обобщённом контексте эквивалентно using std :: begin ; begin ( arg ) ; , что позволяет как перегрузкам, выбранным через ADL для пользовательских типов, так и стандартным шаблонам функций библиотеки находиться в одном наборе перегрузок.

template<typename Container, typename Function>
void for_each(Container&& cont, Function f)
{
    using std::begin;
    auto it = begin(cont);
    using std::end;
    auto end_it = end(cont);
    while (it != end_it)
    {
        f(*it);
        ++it;
    }
}

Примечания

Перегрузки для не-массивов точно отражают поведение C::begin . Их эффекты могут быть неожиданными, если функция-член не имеет разумной реализации.

std::cbegin введен для унификации доступа к диапазонам через члены и нечлены. См. также LWG issue 2128 .

Если C является shallow-const представлением, std::cbegin может возвращать изменяемый итератор. Такое поведение является неожиданным для некоторых пользователей. Смотрите также P2276 и P2278 .

Пример

#include <iostream>
#include <iterator>
#include <vector>
int main() 
{
    std::vector<int> v = {3, 1, 4};
    auto vi = std::begin(v);
    std::cout << std::showpos << *vi << '\n'; 
    int a[] = {-5, 10, 15};
    auto ai = std::begin(a);
    std::cout << *ai << '\n';
}

+3
-5

Смотрите также