cpp/iterator/endのソースを表示

あなたには「このページの編集」を行う権限がありません。理由は以下の通りです:
この操作は、次のグループのいずれかに属する利用者のみが実行できます: 登録利用者、管理者。
このページのソースの閲覧やコピーができます。
{{cpp/title| end | cend }}
{{cpp/iterator/navbar}}
{{dcl begin}}
{{dcl header | iterator}}
{{dcl rev begin|num=1}}
{{dcl | since=c++11 | until=c++17|
template< class C > 
auto end( C& c ) -> decltype(c.end());
}}
{{dcl | since=c++17|
template< class C > 
constexpr auto end( C& c ) -> decltype(c.end());
}}
{{dcl rev end}}
{{dcl rev begin|num=1}}
{{dcl | since=c++11 | until=c++17 |
template< class C > 
auto end( const C& c ) -> decltype(c.end());
}}
{{dcl | since=c++17 |
template< class C > 
constexpr auto end( const C& c ) -> decltype(c.end());
}}
{{dcl rev end}}
{{dcl rev begin|num=2}}
{{dcl | since=c++11 | until=c++14 |
template< class T, std::size_t N > 
T* end( T (&array)[N] );
}}
{{dcl | since=c++14 |
template< class T, std::size_t N > 
constexpr T* end( T (&array)[N] ) noexcept;
}}
{{dcl rev end}}
{{dcl | num=3 | since=c++14 |
template< class C > 
constexpr auto cend( const C& c ) noexcept(/* see below */)
    -> decltype(std::end(c));
}}
{{dcl end}}

指定されたコンテナ {{tt|c}} または配列 {{tt|array}} の終端 (最後の要素の次の要素) を指すイテレータを返します。 これらのテンプレートは {{c|C::end()}} が妥当な実装を持つことを当てにしています。

@1@ 正確に {{c|c.end()}} を返します。 これは一般的には {{tt|c}} によって表されるシーケンスの終端を指すイテレータです。 {{tt|C}} が標準の {{named req|Container}} の場合、 {{tt|c}} が const 修飾されていなければ {{c|C::iterator}} を返し、そうでなければ {{c|C::const_iterator}} を返します。
@2@ 配列 {{tt|array}} の終端を指すポインタを返します。
@3@ 正確に {{c|std::end(c)}} を返します。 {{tt|c}} は常に const 修飾されたものとして扱われます。 {{tt|C}} が標準の {{named req|Container}} の場合、これは常に {{c|C::const_iterator}} を返します。

{{image|range-begin-end.svg}}

===引数===
{{par begin}}
{{par | c | メンバ関数 {{tt|end}} を持つコンテナ}}
{{par | array | 任意の型の配列}}
{{par end}}

===戻り値===
{{tt|c}} または {{tt|array}} の終端を指すイテレータ。 ちなみにコンテナまたは配列の終端は、最後の有効な要素の次の要素として定義されます。

===例外===
@3@ {{noexcept|noexcept(std::end(c))}}

===ノート===
{{cpp/iterator/range access availability|end|cend}}

===ユーザ定義のオーバーロード===
適切な {{tt| end()}} メンバ関数を持たないけれどもイテレート可能なクラスに対して、 {{tt| end}} のカスタムオーバーロードを提供しても構いません。 以下のオーバーロードは標準ライブラリによってすでに提供されています。

{{dsc begin}}
{{dsc inc | cpp/utility/initializer_list/dsc end2}}
{{dsc inc | cpp/numeric/valarray/dsc end2}}
{{dsc inc | cpp/filesystem/directory_iterator/dsc begin}}
{{dsc inc | cpp/filesystem/recursive_directory_iterator/dsc begin}}
{{dsc end}}

{{tt|swap}} の使用 ({{named req|Swappable}} で説明されています) と同様に、一般的な文脈における {{tt| end}} 関数の使用は {{c|using std::end; end(arg);}} と同等です。 これは [[cpp/language/adl|ADL]] によって選択されるユーザ定義型に対するオーバーロードと、標準ライブラリ関数のテンプレートの両方が、同じオーバーロード集合に現れるようにします。
{{source|1=
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;
    }
}
}}

===例===
{{example
 |
 | code=#include <iostream>
#include <vector>
#include <iterator>
#include <algorithm>

int main() 
{
    std::vector<int> v = { 3, 1, 4 };
    if (std::find(std::begin(v), std::end(v), 5) != std::end(v)) {
        std::cout << "found a 5 in vector v!\n";
    }

    int a[] = { 5, 10, 15 };
    if (std::find(std::begin(a), std::end(a), 5) != std::end(a)) {
        std::cout << "found a 5 in array a!\n";
    }
}
 | output=found a 5 in array a!
}}

===関連項目===
{{dsc begin}}
{{dsc inc | cpp/iterator/dsc begin}}
{{dsc end}}

[[de:cpp/iterator/end]]
[[en:cpp/iterator/end]]
[[es:cpp/iterator/end]]
[[fr:cpp/iterator/end]]
[[it:cpp/iterator/end]]
[[pt:cpp/iterator/end]]
[[ru:cpp/iterator/end]]
[[zh:cpp/iterator/end]]
このページで使用されているテンプレート:
cppreference.com

検索

名前空間

変種

表示

操作

cpp/iterator/endのソースを表示
