• Class / Function / Type

      std::
    • Header file

      <>
    • Other / All

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

    履歴 編集

    customization point object
    <ranges>

    std::ranges::crend

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

    概要

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

    効果

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

    戻り値

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

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

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

    備考

    ranges::crend(E)が有効な式であるとき、ranges::crend(E)の型Sranges::crbegin(E)の型Isentinel_for<S, I>のモデルである。C++23以降はさらに、Sinput_iteratorのモデルならばSconstant-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

    処理系

    関連項目

    参照