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

履歴 編集

function
<map>

# std::multimap::end

    iterator end();                    // (1) C++03
    iterator end() noexcept;           // (1) C++11
    constexpr iterator end() noexcept; // (1) C++26

    const_iterator end() const;                    // (2) C++03
    const_iterator end() const noexcept;           // (2) C++11
    constexpr const_iterator end() const noexcept; // (2) C++26

## 概要

`multimap` コンテナの末尾の次を参照するイテレータを取得する。

## 戻り値

コンテナの末尾の次を参照するイテレータ。 `iterator` と `const_iterator` はいずれもメンバ型である。`multimap` クラステンプレートにおいて、これらは双方向イテレータである。

## 計算量

定数時間

## 備考

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

## 例

    #include <iostream>
    #include <map>

    int main()
    {
      std::multimap<int, char> m;
      m.insert(std::make_pair(3, 'C'));
      m.insert(std::make_pair(3, 'D'));
      m.insert(std::make_pair(7, 'G'));
      m.insert(std::make_pair(8, 'H'));
      m.insert(std::make_pair(4, 'D'));
      m.insert(std::make_pair(5, 'E'));
      m.insert(std::make_pair(1, 'A'));
      m.insert(std::make_pair(2, 'B'));
      m.insert(std::make_pair(6, 'F'));

      for( auto i = m.begin(); i != m.end() ; ++i ) {
        std::cout << i->first << " " << i->second << "\n";
      }

      return 0;
    }

### 出力

    1 A
    2 B
    3 C
    3 D
    4 D
    5 E
    6 F
    7 G
    8 H

## バージョン

### 言語

- C++03

### 処理系

- Clang: 2.9 ✅, 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅
- GCC: ??
- ICC: ??
- Visual C++: ??

## 関連項目

名前 | 説明
--- | ---
`multimap::begin` | 先頭を指すイテレータを取得する
`multimap::cbegin` | 先頭を指すconstイテレータを取得する
`multimap::cend` | 末尾の次を指すconstイテレータを取得する
`multimap::rbegin` | 末尾を指す逆イテレータを取得する
`multimap::rend` | 先頭の前を指す逆イテレータを取得する
`multimap::crbegin` | 末尾を指す逆constイテレータを取得する
`multimap::crend` | 先頭の前を指す逆constイテレータを取得する

## 参照

- P3372R3 constexpr containers and adaptors