Assume namespace std throughout.
The C++14 committee draft N3690 defines std::make_unique thus:
[n3690: 20.9.1.4]:unique_ptrcreation [unique.ptr.create]
template <class T, class... Args> unique_ptr<T> make_unique(Args&&... args);1 Remarks: This function shall not participate in overload resolution unless
Tis not an array.
2 Returns:unique_ptr<T>(new T(std::forward<Args>(args)...)).
template <class T> unique_ptr<T> make_unique(size_t n);3 Remarks: This function shall not participate in overload resolution unless
Tis an array of unknown bound.
4 Returns:unique_ptr<T>(new typename remove_extent<T>::type[n]()).
template <class T, class... Args> unspecified make_unique(Args&&...) = delete;5 Remarks: This function shall not participate in overload resolution unless
Tis an array of known bound.
Now, this seems to me to be about as clear as mud, and I think it needs more exposition. But, this editorial comment aside, I believe I've decoded the meanings of each variant:
template <class T, class... Args> unique_ptr<T> make_unique(Args&&... args);Your bog-standard
make_uniquefor non-array types. Presumably the "remark" indicates that some form of static assertion or SFINAE trick is to prevent the template from being successfully instantiated whenTis an array type.At a high-level, see it as the smart-pointer equivalent to
T* ptr = new T(args);.template <class T> unique_ptr<T> make_unique(size_t n);A variant for array types. Creates a dynamically-allocated array of
n×Ts, and returns it wrapped in aunique_ptr<T[]>.At a high-level, see it as the smart-pointer equivalent to
T* ptr = new T[n];.template <class T, class... Args> unspecified make_unique(Args&&...)Disallowed. "unspecified" would probably be
unique_ptr<T[N]>.Would otherwise be the smart-pointer equivalent to something like the invalid
T[N]* ptr = new (keep_the_dimension_please) (the_dimension_is_constexpr) T[N];.
First of all, am I correct? And, if so, what's going on with the third function?
If it's there to disallow programmers from attempting to dynamically-allocate an array while providing constructor arguments for each element (just as
new int[5](args)is impossible), then that's already covered by the fact that the first function cannot be instantiated for array types, isn't it?If it's there to prevent the addition to the language of a construct like
T[N]* ptr = new T[N](whereNis someconstexpr) then, well, why? Wouldn't it be completely possible for aunique_ptr<T[N]>to exist that wraps a dynamically-allocated block ofN×Ts? Would this be such a bad thing, to the extent that the committee has gone out of its way to disallow its creation usingmake_unique?
Why is make_unique<T[N]> disallowed?