5. end

最終更新日時(UTC):
が更新

履歴 編集

function
<list>

std::list::end

iterator end();                      // (1) C++03
iterator end() noexcept;             // (1) C++11
const_iterator end() const;          // (2) C++03
const_iterator end() const noexcept; // (2) C++11

概要

末尾の次を指すイテレータを取得する。

戻り値

末尾の次を指すイテレータ

例外

投げない

備考

  • この関数によって返されるイテレータは、*thisが保持するいずれの要素も参照しない。その指す先は、不正な範囲となるだろう

例

#include <iostream>
#include <list>

int main()
{
  std::list<int>        ls  = { 1, 2, 3 };
  const std::list<int>& cls = ls;

  decltype(ls)::iterator  i    = ls.begin();
  decltype(ls)::iterator  last = ls.end();

  decltype(ls)::const_iterator ci    = cls.begin();
  decltype(ls)::const_iterator clast = cls.end();

  for (; i != last; ++i) {
    std::cout << *i << std::endl;
  }

  for (; ci != clast; ++ci) {
    std::cout << *ci << std::endl;
  }
}

出力

1
2
3
1
2
3

参照