std::any::any
来自cppreference.com
constexpr any() noexcept; |
(1) | (C++17 起) |
any( const any& other ); |
(2) | (C++17 起) |
any( any&& other ) noexcept; |
(3) | (C++17 起) |
template< class ValueType > any( ValueType&& value ); |
(4) | (C++17 起) |
template< class ValueType, class... Args > explicit any( std::in_place_type_t<ValueType>, Args&&... args ); |
(5) | (C++17 起) |
template< class ValueType, class U, class... Args > explicit any( std::in_place_type_t<ValueType>, std::initializer_list<U> il, |
(6) | (C++17 起) |
构造新的 any
对象。
1) 构造空对象。
2-3) 复制 (2) 或移动 (3)
other
的内容进新实例,从而任何内容的类型和值都等于构造函数调用前的 other
所拥有者,或者若 other
为空则内容为空。正式地说,2) 若
other
为空,则构造的对象为空。否则,等价于 any(std::in_place_type<T>, std::any_cast<const T&>(other)) ,其中 T
是 other
中含有的对象类型。3) 若
other
为空,则构造的对象为空,否则,构造的对象含 other
中容纳的对象,或从 other
中的对象构造的同类型对象,考虑该对象是否为右值。4) 构造对象,其初始内容为 std::decay_t<ValueType> 类型对象,从 std::forward<ValueType>(value) 直接初始化它。
- 此重载只有在 std::decay_t<ValueType> 既非与 any 相同类型,亦非std::in_place_type_t 的特化,且 std::is_copy_constructible_v<std::decay_t<ValueType>> 为true 时才会参与重载决议。
5) 构造对象,其初始内容为
std::decay_t<ValueType>
类型对象,从 std::forward<Args>(args)... 直接非列表初始化它。
- 此重载只有在 std::is_constructible_v<std::decay_t<ValueType>, Args...> 与 std::is_copy_constructible_v<std::decay_t<ValueType>> 皆为 true 时才会参与重载决议。
6) 构造对象,其初始内容为
std::decay_t<ValueType>
类型对象,从 il, std::forward<Args>(args)... 直接非列表初始化它。
- 此重载只有在 std::is_constructible_v<std::decay_t<ValueType>, std::initializer_list<U>&, Args...> 与 std::is_copy_constructible_v<std::decay_t<ValueType>> 皆为 true 时才会参与重载决议。
模板形参
ValueType | - | 所含的值类型 |
类型要求 | ||
-std::decay_t<ValueType> 必须符合可复制构造 (CopyConstructible) 的要求。
|
参数
other | - | 另一个用以复制或移动的 any 对象
|
value | - | 初始化所含的值 |
il, args | - | 传递给所含对象的构造函数的参数 |
异常
2,4,5,6) 抛出任何所含类型的构造函数所抛出的异常
注解
默认构造函数为 constexpr
,故静态 std::any
在任何动态非局部初始化开始之前,作为静态非局部初始化的一部分初始化。这使得在任何静态对象的构造函数中使用 std::any
对象是安全的。
参阅
赋值 any 对象 (公开成员函数) |