base.md

base

• iterator[meta header]
• std[meta namespace]
• move_iterator[meta class]
• function[meta id-type]
• cpp11[meta cpp]

Iterator base() const;                              // (1) C++11
constexpr Iterator base() const;                    // (1) C++17
constexpr const Iterator& base() const & noexcept;  // (1) C++20

constexpr Iterator base() &&;   // (2)

概要

メンバ変数として保持している、元のイテレータを取得する。

戻り値

• (1)
  • C++17まで : 元のイテレータをコピーして返す。
  • C++20 : 元のイテレータへのconst参照を返す。
• (2) : 元のイテレータをムーブして返す。

例

#include <iostream>
#include <vector>
#include <memory>
#include <iterator>

int main()
{
  std::vector<std::unique_ptr<int>> v;
  for (int i = 0; i < 5; ++i)
    v.emplace_back(new int(i));

  std::move_iterator<decltype(v)::iterator> it1(v.begin());

  decltype(v)::iterator base = it1.base();
  std::cout << **base << std::endl;
}

• base()[color ff0000]
• v.emplace_back[link /reference/vector/vector/emplace_back.md]

出力

0

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC: 4.7.0 [mark verified]
• ICC: ??
• Visual C++: ??

参照

• P0031R0 A Proposal to Add Constexpr Modifiers to reverse_iterator, move_iterator, array and Range Access
• P1207R4 Movability of Single-pass Iterators
• LWG Issue 3391. Problems with counted_iterator/move_iterator::base() const &
• LWG Issue 3593. Several iterators' base() const & and lazy_split_view::outer-iterator::value_type::end() missing noexcept