std::allocate_shared

来自cppreference.com
< cpp‎ | memory‎ | shared ptr
 
 
 
 
 
定义于头文件 <memory>
template< class T, class Alloc, class... Args >
shared_ptr<T> allocate_shared( const Alloc& alloc, Args&&... args );
(1) (C++11 起)
(T 非数组)
template<class T, class A>
shared_ptr<T> allocate_shared(const A& a, std::size_t N);
(2) (C++20 起)
(T 为 U[])
template<class T, class A>
shared_ptr<T> allocate_shared(const A& a);
(3) (C++20 起)
(T 为 U[N])
template<class T, class A>

shared_ptr<T> allocate_shared(const A& a, std::size_t N,

                              const std::remove_extent_t<T>& u);
(4) (C++20 起)
(T 为 U[])
template<class T, class A>

shared_ptr<T> allocate_shared(const A& a,

                              const std::remove_extent_t<T>& u);
(5) (C++20 起)
(T 为 U[N])
1)argsT 的构造函数参数列表,构造 T 类型对象并将它包装于 std::shared_ptr 。对象如同以表达式 std::allocator_traits<A2>::construct(a, pv, v)) 构造,其中 pv 是内部指向适合保有 T 类型对象的存储的 void* 指针,而 a 是可能重绑的分配器副本。存储典型地大于 sizeof(T) ,以对共享指针控制块和 T 对象使用一次分配。此函数所调用的 std::shared_ptr 构造函数以指向新构造的 T 类型对象指针启用 shared_from_this 。所有内存分配用 alloc 的副本执行,而它必须满足分配器 (Allocator) 要求。此重载仅当 T 不是数组类型才参与重载决议。
2,3)(1) ,但构造的元素是可能多维的数组,其每个非数组元素如同以表达式 std::allocator_traits<A2>::construct(a2, pv) 初始化,其中 A2 类型的 a2 是重绑定义管理 std::remove_all_extents_t<T> 类型对象的分配器副本。重载 (2) 创建第一维上大小为 N 的数组。数组元素以其地址递增顺序初始化。
4,5)(2,3) ,但每个元素从默认值 u 初始化。若 U 不是数组类型,则这如同以与 (1) 中相同的分配器表达式进行,除了分配器重绑到 std::remove_extent_t<T> 。否则,这如同以如同 (1) 中的分配器表达式,从来自 u 的对应元素初始化(可能多维的)数组的每个非数组元素,除了分配器重绑到 std::remove_extent_t<T> 类型。重载 (4) 创建第一维上大小为 N 的数组。数组元素以其地址递增顺序初始化。

目录

[编辑] 参数

alloc - 使用的分配器 (Allocator) 。
args... - 构造 T 示例将要用到的参数列表。
N - 所用的数组大小
u - 初始化数组每个元素的初值

[编辑] 返回值

T 类型实例的的 std::shared_ptr

[编辑] 异常

能抛出从 Alloc::allocate() 抛出的异常,或从 T 构造函数抛出的异常。若抛出异常,则 (1) 无效果。若异常在数组的构造中抛出,则已初始化元素以逆序销毁。 (C++20 起)

[编辑] 注意

类似 std::make_shared ,此函数典型地只进行一次分配,并将 T 对象与控制块置于分配的内存块中(标准推荐但不要求如此,所有已知实现均如此)。 alloc 的副本作为控制块的一部分存储,从而它能用于解分配之,若所有共享及若引用计数抵达零。

不同于 std::shared_ptr 构造函数, std::allocate_shared 不接受分离的自定义删除器:用提供的分配器析构控制块和 T 对象,及解分配其共享内存块。

std::shared_ptr 支持数组类型(从 C++17 起),但 std::allocate_shared 不支持。此功能为 boost::allocate_shared 所支持。

(C++20 前)

构造函数以 U* 类型指针 ptr启用 shared_from_this ,表示它确定 U 是否拥有是 std::enable_shared_from_this 特化的无歧义且可访问 (C++17 起)基类,而且若如此,则构造函数求值该语句:

if (ptr != nullptr && ptr->weak_this.expired())
  ptr->weak_this = std::shared_ptr<std::remove_cv_t<U>>(*this,
                                  const_cast<std::remove_cv_t<U>*>(ptr));

其中 weak_thisstd::shared_from_this 的隐藏 mutable std::weak_ptr 成员。对 weak_this 成员的赋值不是原子的,且与任何到同一对象的潜在并发访问冲突。这确保到 shared_from_this() 的未来调用将与此裸指针构造函数所创建的 shared_ptr 共享所有权。

上述解释代码中,测试 ptr->weak_this.expired() 确保 weak_this 不被重赋值,若它已指示所有者。从 C++17 起要求此测试。

[编辑] 参阅

构造新的 shared_ptr
(公开成员函数) [编辑]
从参数创建并返回shared_ptr,便于类型推断
(函数模板) [编辑]