最終更新日時(UTC): 2026年02月17日 14時22分33秒
Akira Takahashi が更新

履歴 編集

function
<set>

# std::set::cend(C++11)

    const_iterator cend() const noexcept;           // (1) C++11
    constexpr const_iterator cend() const noexcept; // (1) C++26

## 概要

`set` コンテナの末尾の次を参照する読み取り専用イテレータを取得する。

## 戻り値

コンテナの末尾の次を参照する読み取り専用イテレータ。

`const_iterator` はメンバ型である。`set` クラステンプレートにおいて、これは双方向イテレータである。

## 計算量

定数時間

## 備考

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

## 例

    #include <iostream>
    #include <set>
    #include <algorithm>

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

      // このアルゴリズム内ではcの書き換えを決して行わない
      std::for_each(c.cbegin(), c.cend(), [](const int& x) {
        std::cout << x << std::endl;
      });
    }

### 出力

    1
    2
    3

## 関連項目

名前 | 説明
--- | ---
`cbegin` | 先頭を指す読み取り専用イテレータを取得する
`rbegin` | 末尾を指す逆イテレータを取得する
`rend` | 先頭の前を指す逆イテレータを取得する

## 参照

- P3372R3 constexpr containers and adaptors