forked from boostorg/smart_ptr
cb0797acf0
Implement shared_ptr<X[]>, weak_ptr<X[]>. Refs #1113. ........ Fix shared_ptr<T[]> EDG issues. ........ Disable make_shared<T> overloads when T is Q[]. ........ Add catch(...) clauses to sp_array_test.cpp. ........ Add allocate_shared and make_shared for shared_ptr arrays of runtime size. Fulfills need for allocate_shared_array and make_shared_array. ........ Update Jamfile.v2 to run make_shared array tests and allocate_shared array tests. ........ Fix g++ issues. ........ Add specialization of sp_if_not_array<T[N]>. ........ Rename make_shared.hpp to make_shared_object.hpp, include from make_shared.hpp. ........ Add make_shared_array_args_test.cpp. ........ Add support for make_shared of array of arrays. Correctly destroy elements and construct elements for the variadic template constructor variants. ........ Fix sp_convertible<T const[], T const[]>. ........ Update smart_ptr/detail/array_helper to have create and create_noinit for non-array case. ........ Rename sp_convertible_test.cpp to shared_ptr_convertible_test.cpp. ........ Don't treat array_helper create and create_noinit for array types as a special case. ........ Add sp_convertible_test.cpp. ........ Fix array_helper (create_noinit and use of args...). ........ Update allocate_shared and make_shared to treat multidimensional array as single dimension. Remove detail array_helper. Add detail array traits. Update tests. ........ Simplify array_deleter interface ........ Add missing semicolon. ........ Fix typo. ........ Add tests for variadic template constructors overload of array forms of make_shared and allocate_shared for multidimensional arrays and up to 9 constructor arguments. ........ Add support for shared_ptr<X[N>. ........ Add C++11 initializer list support for make_shared and allocate_shared array forms. ........ Clean up code in allocate_shared_array.hpp and make_shared_array.hpp ........ Change make_shared and allocate_shared array form semantics with initializer lists overload that takes no size. ........ Disable make_shared for arrays when the compiler doesn't support partial specialization or SFINAE. ........ For allocate_shared and make_shared: Separate test case that g++ does support yet. Remove macros testing for no partial specialization in traits. Add additional traits. ........ Actually remove test cases from make_shared_array_create_test.cpp and allocate_shared_array_create_test.cpp that g++ does not handle. ........ Add overloads to support fixed size arrays, T[N], to allocate_shared (variadic) and make_shared (variadic) and make_shared_noinit. ........ Add additional overload for make_shared and allocate_shared for arrays for fixed size arrays and initializer lists. ........ Add assertion to overload of make_shared and allocate_shared for T[N] with initializer lists. Rename detail type to be more intuitive. ........ Add allocate_shared_array_args_test.cpp. ........ Keep old definition of sp_assert_convertible when BOOST_SP_NO_SP_CONVERTIBLE is set. ........ Updated shared_array to match shared_ptr. Refs #1113. ........ Add final overload of make_shared and allocate_shared (array forms) for T[][N] with C++11 initializer lists. ........ Change traits for initializer list for g++ ........ Tidy long line formatting in allocate_shared_array.hpp and make_shared_array.hpp ........ Update tests for make_shared and allocate_shared array forms, for normal case, initializer lists, variadic template arguments, for arrays and fixed size arrays. ........ Update Jamfile.v2 with two new smart_ptr tests for allocate_shared and make_shared ........ [SVN r81339]
130 lines
7.1 KiB
HTML
130 lines
7.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>make_shared and allocate_shared</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
</head>
|
|
<body text="#000000" bgColor="#ffffff" link="#0000ff" vlink="#0000ff">
|
|
<h1><IMG height="86" alt="boost.png (6897 bytes)" src="../../boost.png"
|
|
width="277" align="middle" border="0">make_shared and allocate_shared
|
|
for arrays</h1>
|
|
<p><A href="#Introduction">Introduction</A><br>
|
|
<A href="#Synopsis">Synopsis</A><br>
|
|
<A href="#functions">Free Functions</A><br>
|
|
<A href="#example">Example</A><br>
|
|
<h2><a name="Introduction">Introduction</a></h2>
|
|
<p>One criticism of Boost <a href="shared_array.htm">shared_array</a> is
|
|
the lack of utility similar to <a href="make_shared.htm">make_shared</a>
|
|
which ensures only a single allocation for an array. A second criticism
|
|
is Boost <code>shared_array</code> does not support custom allocators
|
|
and so also lacks an <code>allocate_shared</code> utility.</p>
|
|
<p>The header files <boost/smart_ptr/make_shared_array.hpp> and
|
|
<boost/smart_ptr/allocate_shared_array.hpp> provide new function
|
|
templates, <code>make_shared</code> and <code>allocate_shared</code>,
|
|
to address this need. <code>make_shared</code> uses the global
|
|
operator <code>new</code> to allocate memory, whereas
|
|
<code>allocate_shared</code> uses an user-supplied allocator,
|
|
allowing finer control.</p>
|
|
<h2><a name="Synopsis">Synopsis</a></h2>
|
|
<pre>namespace boost {
|
|
template<typename T>
|
|
shared_ptr<T[]> <a href="#functions">make_shared</a>(size_t size);
|
|
|
|
template<typename T, typename A>
|
|
shared_ptr<T[]> <a href="#functions">allocate_shared</a>(const A& allocator, size_t size);
|
|
|
|
#if defined(BOOST_HAS_VARIADIC_TMPL) && defined(BOOST_HAS_RVALUE_REFS)
|
|
template<typename T, typename... Args>
|
|
shared_ptr<T[]> <a href="#functions">make_shared</a>(size_t size, Args&&... args);
|
|
|
|
template<typename T, typename... Args>
|
|
shared_ptr<T[N]> <a href="#functions">make_shared</a>(Args&&... args);
|
|
|
|
template<typename T, typename A, typename... Args>
|
|
shared_ptr<T> <a href="#functions">allocate_shared</a>(const A& allocator, size_t size, Args&&... args);
|
|
|
|
template<typename T, typename A, typename... Args>
|
|
shared_ptr<T[N]> <a href="#functions">allocate_shared</a>(const A& allocator, Args&&... args);
|
|
#endif
|
|
|
|
#if !defined(BOOST_NO_CXX11_HDR_INITIALIZER_LIST)
|
|
template<typename T, typename... Args>
|
|
shared_ptr<T[]> <a href="#functions">make_shared</a>(initializer_list<T> list);
|
|
|
|
template<typename T, typename... Args>
|
|
shared_ptr<T[N]> <a href="#functions">make_shared</a>(initializer_list<T> list);
|
|
|
|
template<typename T, typename... Args>
|
|
shared_ptr<T[][N]> <a href="#functions">make_shared</a>(size_t size, initializer_list<T> list);
|
|
|
|
template<typename T, typename A, typename... Args>
|
|
shared_ptr<T[]> <a href="#functions">allocate_shared</a>(const A& allocator, initializer_list<T> list);
|
|
|
|
template<typename T, typename A, typename... Args>
|
|
shared_ptr<T[N]> <a href="#functions">allocate_shared</a>(const A& allocator, initializer_list<T> list);
|
|
|
|
template<typename T, typename A, typename... Args>
|
|
shared_ptr<T[][N]> <a href="#functions">allocate_shared</a>(const A& allocator, size_t size, initializer_list<T> list);
|
|
#endif
|
|
|
|
template<typename T>
|
|
shared_ptr<T> <a href="#functions">make_shared_noinit</a>(size_t size);
|
|
|
|
template<typename T>
|
|
shared_ptr<T[N]> <a href="#functions">make_shared_noinit</a>();
|
|
}</pre>
|
|
<h2><a name="functions">Free Functions</a></h2>
|
|
<pre>template<typename T, typename... Args>
|
|
shared_ptr<T> make_shared(size_t size, Args&&... args);
|
|
template<typename T, typename A, typename... Args>
|
|
shared_ptr<T> allocate_shared(const A& allocator, size_t size, Args&&... args);</pre>
|
|
<blockquote>
|
|
<p><b>Requires:</b> The expression
|
|
<code>new(pointer) T(forward<Args>(args)...)</code>, where
|
|
<code>pointer</code> is a <code>void*</code> pointing to storage
|
|
suitable to hold an object of type <code>T</code>, shall be
|
|
well-formed. <code>A</code> shall be an <em>Allocator</em>, as
|
|
described in section 20.1.5 (<strong>Allocator requirements</strong>)
|
|
of the C++ Standard. The copy constructor and destructor of
|
|
<code>A</code> shall not throw.</p>
|
|
<p><b>Effects:</b> Allocates memory suitable for an array of type
|
|
<code>T</code> and size <code>size</code> and constructs an array
|
|
of objects in it via the placement new expression
|
|
<code>new(pointer) T()</code> or
|
|
<code>new(pointer) T(forward<Args>(args)...)</code>.
|
|
<code>allocate_shared</code> uses a copy of
|
|
<code>allocator</code> to allocate memory. If an exception is thrown,
|
|
has no effect.</p>
|
|
<p><b>Returns:</b> A <code>shared_ptr</code> instance that stores and
|
|
owns the address of the newly constructed array of type <code>T</code>
|
|
and size <code>size</code>.</p>
|
|
<p><b>Postconditions:</b>
|
|
<code>get() != 0 && use_count() == 1</code>.</p>
|
|
<p><b>Throws:</b> <code>bad_alloc</code>, or an exception thrown from
|
|
<code>A::allocate</code> or the constructor of <code>T</code>.</p>
|
|
<p><b>Notes:</b> This implementation allocates the memory required for
|
|
the returned <code>shared_ptr</code> and an array of type
|
|
<code>T</code> of size <code>size</code> in a single allocation. This
|
|
provides efficiency to equivalent to an intrusive smart array
|
|
pointer.</p>
|
|
<p>The prototypes shown above are used if your compiler supports r-value
|
|
references and variadic templates. They perfectly forward the
|
|
<code>args</code> parameters to the constructors of
|
|
<code>T</code> for each array element.</p>
|
|
<p>Otherwise, you can use the overloads which take only the array size
|
|
(and the allocator in case of <code>allocate_shared</code>) and do not
|
|
take any constructor arguments. These overloads invoke the default
|
|
constructor of <code>T</code> for each array element.</p>
|
|
</blockquote>
|
|
<h2><a name="example">Example</a></h2>
|
|
<pre>boost::shared_ptr<int[]> array = boost::make_shared<int[]>(size);</pre>
|
|
<hr>
|
|
<p>$Date: 2012-10-30 10:12:25 -0800 (Tue, 30 Oct 2012) $</p>
|
|
<p><small>Copyright 2012 Glen Fernandes. Distributed under the Boost
|
|
Software License, Version 1.0. See accompanying file
|
|
<A href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> or copy at
|
|
<A href="http://www.boost.org/LICENSE_1_0.txt">
|
|
http://www.boost.org/LICENSE_1_0.txt</A>.</small></p>
|
|
</body>
|
|
</html>
|