GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing cpprefjp.github.io — std::unordered_map::begin - cpprefjp C++日本語リファレンス

最終更新日時: 2026年09月11日 13時06分31秒 (JST)
Akira Takahashi が更新

function

<unordered_map>

std::unordered_map::begin(C++11)

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

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

概要

先頭の要素を指すイテレータを取得する。

unordered_map は非順序連想コンテナであるため「先頭」に特に意味はないが、begin() で得られたイテレータを end() まで operator++() でイテレートすることで当該コンテナの要素を漏れなくダブりなく走査できる。

戻り値

先頭の要素を指すイテレータ

例外

投げない。

計算量

定数

例

#include <iostream>
#include <string>
#include <algorithm>
#include <utility>
#include <unordered_map>

int main()
{
  using mymap = std::unordered_map<std::string, int>;

  mymap um{ { "1st", 1 }, { "2nd", 2 }, { "3rd", 3 }, };
  const mymap cum{um};

  std::for_each(um.begin(), um.end(), [](mymap::value_type p)
    { std::cout << '{' << p.first << ',' << p.second << "}, "; });
  std::cout << std::endl;

  std::for_each(cum.begin(), cum.end(), [](mymap::value_type p)
    { std::cout << '{' << p.first << ',' << p.second << "}, "; });
  std::cout << std::endl;
}

出力例

{3rd,3}, {2nd,2}, {1st,1},
{3rd,3}, {2nd,2}, {1st,1},

注：unordered_map は非順序連想コンテナであるため、出力順序は無意味であることに注意

バージョン

言語

C++11

処理系

Clang: 3.0 ✅, 3.1 ✅
GCC: 4.4.7 ✅, 4.5.3 ✅, 4.6.3 ✅, 4.7.0 ✅
Visual C++: ?

関連項目

名前	説明
`end`	最終要素の次を指すイテレータの取得
`cbegin`	先頭要素を指す読み取り専用イテレータの取得
`cend`	最終要素の次を指す読み取り専用イテレータの取得
`begin(size_type)`	インデックス（添え字）で指定したバケット内の先頭要素を指すイテレータを取得
`end(size_type)`	インデックス（添え字）で指定したバケット内の最終要素の次を指すイテレータを取得
`cbegin(size_type)`	インデックス（添え字）で指定したバケット内の先頭要素を指す読み取り専用イテレータを取得
`cend(size_type)`	インデックス（添え字）で指定したバケット内の最終要素の次を指す読み取り専用イテレータを取得

参照

P3372R3 constexpr containers and adaptors

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.