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

履歴 編集

function
<flat_map>

# std::flat_multimap::begin(C++23)

    iterator begin() noexcept;           // (1) C++23
    constexpr iterator begin() noexcept; // (1) C++26

    const_iterator begin() const noexcept;           // (2) C++23
    constexpr const_iterator begin() const noexcept; // (2) C++26

## 概要

コンテナの先頭のキーと要素のpairを参照するイテレータを取得する。

内部的に、コンテナは要素を下位から上位へと並べており、従って`begin()`はコンテナ内の最下位のキーにあたるpairへのイテレータを返す。

## 戻り値

コンテナの先頭要素へのイテレータ。 `iterator` と `const_iterator` はともにメンバ型である。このクラステンプレートにおいて、これらはランダムアクセスイテレータである。

## 計算量

定数時間。

## 例

    #include <flat_map>
    #include <iostream>

    int main()
    {
      std::flat_multimap<int, char> fm = {
        {10, 'A'}, {11, 'B'}, {12, 'C'},
        {10, 'a'}, {11, 'b'}, {12, 'c'},
      };

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

### 出力

    10 A
    10 a
    11 B
    11 b
    12 C
    12 c

## バージョン

### 言語

- C++23

### 処理系

- Clang: ??
- GCC: ??
- Visual C++: ??

## 関連項目

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

## 参照

- P3372R3 constexpr containers and adaptors