make_unique.md

make_unique

• memory[meta header]
• std[meta namespace]
• function template[meta id-type]
• cpp14[meta cpp]

namespace std {
  template <class T, class... Args>
  unique_ptr<T> make_unique(Args&&... args);   // (1)

  template <class T>
  unique_ptr<T> make_unique(size_t n);         // (2)

  template <class T, class... Args>
  unspecified make_unique(Args&&...) = delete; // (3)
}

• unique_ptr[link unique_ptr.md]
• unspecified[italic]

概要

unique_ptrオブジェクトを構築する。

• (1) : 非配列型Tのコンストラクタ引数を受け取り、unique_ptr<T>オブジェクトを構築する。
• (2) : 配列型Tの要素数を受け取り、unique_ptr<T>オブジェクトを構築する。
• (3) : (1)に配列型が指定された場合に、許可されていないオーバーロードとして宣言される。

戻り値

• (1) : unique_ptr<T>(new T(std::forward<Args>(args)...))
• (2) : unique_ptr<T>(new remove_extent_t<T>[n]())

備考

• (1) : 型Tが配列型である場合、この関数はオーバーロード解決の候補に入ってはならない。
• (2), (3) : 型Tが要素数不明の配列型でない場合、この関数はオーバーロード解決の候補に入ってはならない。

例

#include <iostream>
#include <memory>
#include <utility>

int main()
{
  // (1)
  // 型Tのコンストラクタ引数を受け取ってunique_ptrオブジェクトを構築。
  //
  // ここでは、型std::pair<First, Second>のunique_ptrオブジェクトを構築するために、
  // First型とSecond型の引数を渡している。
  std::unique_ptr<std::pair<int, int>> p1 = std::make_unique<std::pair<int, int>>(3, 1);
  std::cout << p1->first << ':' << p1->second << std::endl;

  // (2)
  // 型T[]の要素数を受け取ってunique_ptr<T[]>オブジェクトを構築。
  //
  // ここでは、要素数3の、int型動的配列を構築している。
  std::unique_ptr<int[]> p2 = std::make_unique<int[]>(3);
  p2[0] = 1;
  p2[1] = 2;
  p2[3] = 3;
}

• std::make_unique[color ff0000]

出力

3:1

バージョン

言語

• C++14

処理系

• Clang, C++14 mode: 3.4
• GCC, C++14 mode: 4.9
• ICC: ??
• Visual C++: 2013, 2015

参照

• N3588 make_unique
• N3656 make_unique (Revision 1)

関連項目

• std::shared_ptrの推論補助