std::any::any

来自cppreference.com
< cpp‎ | utility‎ | any
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)
 
 
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,

              Args&&... args );
(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)) ,其中 Tother 中含有的对象类型。
3)other 为空,则构造的对象为空,否则,构造的对象含 other 中容纳的对象,或从 other 中的对象构造的同类型对象,考虑该对象是否为右值。
4) 构造对象,其初始内容为 std::decay_t<ValueType> 类型对象,从 std::forward<ValueType>(value) 直接初始化它。
5) 构造对象,其初始内容为 std::decay_t<ValueType> 类型对象,从 std::forward<Args>(args)... 直接非列表初始化它。
6) 构造对象,其初始内容为 std::decay_t<ValueType> 类型对象,从 il, std::forward<Args>(args)... 直接非列表初始化它。

模板形参

ValueType - 所含的值类型
类型要求
-
std::decay_t<ValueType> 必须符合可复制构造 (CopyConstructible) 的要求。

参数

other - 另一个用以复制或移动的 any 对象
value - 初始化所含的值
il, args - 传递给所含对象的构造函数的参数

异常

2,4,5,6) 抛出任何所含类型的构造函数所抛出的异常

注解

默认构造函数为 constexpr ,故静态 std::any 在任何动态非局部初始化开始之前,作为静态非局部初始化的一部分初始化。这使得在任何静态对象的构造函数中使用 std::any 对象是安全的。

参阅

赋值 any 对象
(公开成员函数)