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 viewである場合、 std::cbeginはmutable iteratorを返す可能性があります。この動作は一部のユーザーにとって予期せぬものです。関連資料： 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

関連項目