std::stack::コンストラクタ

// C++03まで
explicit stack(const Container& cont = Container());  // (1),(2)

// C++11以降 C++17まで
explicit stack(const Container& cont);           // (2)
explicit stack(Container&& cont = Container());  // (1),(3)

// C++20以降
stack() : stack(Container()) {}    // (1)
explicit stack(const Container&);  // (2)
explicit stack(Container&&);       // (3)

template<class InputIterator>
stack(InputIterator first, InputIterator last);       // (4) C++23

template <class Allocator>
explicit stack(const Allocator& alloc);               // (5) C++11

template <class Allocator>
stack(const Container& cont, const Allocator& alloc); // (6) C++11

template <class Allocator>
stack(Container&& cont, const Allocator& alloc);      // (7) C++11

template <class Allocator>
stack(const stack& st, const Allocator& alloc);       // (8) C++11

template <class Allocator>
stack(stack&& st, const Allocator& alloc);            // (9) C++11

template<class InputIterator, class Alloc>
stack(InputIterator first, InputIterator last, const Alloc&);  // (10) C++23

概要

(1) : デフォルトコンストラクタ。
(2) : 元となるコンテナのコピーを受け取るコンストラクタ。
(3) : 元となるコンテナの一時オブジェクトをムーブで受け取るコンストラクタ。
(4) : 元となるコンテナをイテレータペアで受け取るコンストラクタ。
(5) : アロケータを受け取るコンストラクタ。
(6) : 元となるコンテナのコピーとアロケータを受け取るコンストラクタ。
(7) : 元となるコンテナの一時オブジェクトとアロケータを受け取るコンストラクタ。
(8) : アロケータを受け取るコピーコンストラクタ。
(9) : アロケータを受け取るムーブコンストラクタ。
(10) : 元となるコンテナのイテレータペアとアロケータを受け取るコンストラクタ。

効果

(2) : メンバ変数cをcontのコピーで初期化する。
(3) : メンバ変数cをstd::move(cont)で初期化する。
(4) : メンバ変数cを2つの引数first, lastで初期化する。
(5) : メンバ変数cのメモリアロケートにallocを使用する。
(6) : メンバ変数cをContainer(cont, alloc)で初期化する。
(7) : メンバ変数cをContainer(std::move(cont), alloc)で初期化する。
(8) : メンバ変数cをContainer(st.c, alloc)で初期化する。
(9) : メンバ変数cをContainer(std::move(st.c), alloc)で初期化する。
(10) : メンバ変数cを3つの引数first, last, allocで初期化する。

例

#include <iostream>
#include <utility>
#include <vector>
#include <stack>

int main()
{
  // デフォルトでは Container == deque<T>
  std::vector<int> v;

  // 要素を追加
  v.push_back(1);
  v.push_back(2);
  v.push_back(3);

  // vec を引数に構築
  std::stack<int, std::vector<int>> st(std::move(v));

  while (!st.empty()) {
    std::cout << st.top() << " "; // 末尾要素を参照する
    st.pop(); // 末尾要素を削除
  }
}

出力

3 2 1

参照

P0935R0 Eradicating unnecessarily explicit default constructors from the standard library
- C++20でのデフォルトコンストラクタの分離
P1425R4 Iterators pair constructors for stack and queue
- C++23でのイテレータペアへの対応