4. crend

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

履歴 編集

customization point object
<ranges>

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

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

概要

Rangeの先頭の前を指す、読み取り専用逆イテレータもしくは番兵を取得する関数オブジェクト。

効果

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

戻り値

Rangeの先頭の前を指す、読み取り専用逆イテレータもしくは番兵。

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

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

備考

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

例

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

void print(int x)
{
  std::cout << x << " ";
}

int main()
{
  // コンテナ
  {
    std::vector<int> v = {1, 2, 3};

    decltype(v)::const_reverse_iterator first = std::ranges::crbegin(v);
    decltype(v)::const_reverse_iterator last = std::ranges::crend(v);

    std::for_each(first, last, print);
  }
  std::cout << std::endl;

  // 組み込み配列
  {
    int ar[] = {4, 5, 6};

    std::reverse_iterator<const int*> first = std::ranges::crbegin(ar);
    std::reverse_iterator<const int*> last = std::ranges::crend(ar);

    std::for_each(first, last, print);
  }
  std::cout << std::endl;

  // 初期化子リスト
  {
    std::initializer_list<int> init = {7, 8, 9};

    std::reverse_iterator<const int*> first = std::ranges::crbegin(init);
    std::reverse_iterator<const int*> last = std::ranges::crend(init);

    std::for_each(first, last, print);
  }
}

出力

3 2 1 
6 5 4 
9 8 7

バージョン

言語

  • C++20

処理系

関連項目

参照