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

履歴 編集

function
<unordered_set>

std::unordered_set::end(size_type)(C++11)

local_iterator end(size_type n);
const_local_iterator end(size_type n) const;

概要

インデックス(添え字)で指定したバケット内の最後の要素の次を指すイテレータを取得する。

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

要件

パラメータ n[0, bucket_count()) の範囲でなければならない。

戻り値

インデックス(添え字) n で指定したバケット内の最後の要素の次を指すイテレータ

計算量

定数

備考

const 版ではない end が返す local_iterator も読み取り専用イテレータである。

(が、local_iteratorconst_local_iterator が同じ型とは限らないと思われる)

#include <iostream>
#include <string>
#include <unordered_set>
#include <algorithm>
#include <iterator>

int main()
{
  std::unordered_set<std::string> us{ "A", "B", "C", "D", "E", };

  decltype(us)::size_type c = us.bucket_count();
  std::cout << "bucket_count() = " << c << std::endl;

  for (decltype(us)::size_type b = 0; b < c; ++b) {
    decltype(us)::size_type s = us.bucket_size(b);
    std::cout << "bucket = " << b << ", bucket_size = " << s << ", keys = { ";
    std::copy(us.begin(b), us.end(b), std::ostream_iterator<std::string>(std::cout, ", "));
    std::cout << "}" << std::endl;
  }
}

出力

bucket_count() = 5
bucket = 0, bucket_size = 1, keys = { E, }
bucket = 1, bucket_size = 1, keys = { D, }
bucket = 2, bucket_size = 0, keys = { }
bucket = 3, bucket_size = 1, keys = { A, }
bucket = 4, bucket_size = 2, keys = { C, B, }

バージョン

言語

  • C++11

処理系

関連項目

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