std::ranges::cend(C++20)

namespace std::ranges {
  inline namespace /*unspecified*/ {
    inline constexpr /*unspecified*/ cend = /*unspecified*/;
  }
}

概要

Rangeから、最後尾要素の次を指す読み取り専用イテレータもしくは番兵を取得する関数オブジェクト。

効果

部分式Eの型をT、Eの評価結果オブジェクトを示す左辺値をtとする。このとき、式ranges::cend(E)の効果は以下の式と等しい。

C++20まで
1. Eがlvalueであれば、ranges::end(static_cast<const T&>(E))
2. それ以外の場合、ranges::end(static_cast<const T&&>(E))
C++23から
1. Eが右辺値であり、enable_borrowed_range<remove_cv_t<T>>がfalseとなる場合、ranges::cend(E)は不適格
2. それ以外の場合、式Uをranges::end(possibly-const-range(t))とすると、const_sentinel<decltype(U)>(U)

戻り値

最後尾要素の次を指す読み取り専用イテレータもしくは番兵。

カスタマイゼーションポイント

Rangeがconstな場合についてranges::endをカスタマイズすることで、ranges::cendをカスタマイズできる。

備考

ranges::cend(E)が有効な式であるとき、ranges::cend(E)の型S、ranges::cbegin(E)の型Iはsentinel_for<S, I>のモデルである。C++23以降はさらに、Sがinput_iteratorのモデルならばSはconstant-iteratorのモデルである。

例

#include <iostream>
#include <vector>
#include <ranges>
#include <algorithm>

int main()
{
  std::vector<int> v = {1, 2, 3};

  decltype(v)::const_iterator first = std::ranges::cbegin(v);
  decltype(v)::const_iterator last = std::ranges::cend(v);

  std::for_each(first, last, [](const int& x) {
    std::cout << x << std::endl;
  });
}

出力

1
2
3

std::ranges::cend(C++20)

概要

効果

戻り値

カスタマイゼーションポイント

備考

例

出力

バージョン

言語

処理系

関連項目

参照