C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 程序支持工具
- std::initializer_list
- 函数对象
- std::hash
- std::pair
- std::tuple
- std::optional
- std::any
- std::any::reset
- std::any::any
- std::any::~any
- std::any::operator=
- std::any::emplace
- std::any::swap
- std::any::has_value
- std::any::type
- std::swap(std::any)
- std::any_cast
- std::make_any
- std::bad_any_cast
- std::apply
- 库特性测试宏 (C++20)
- std::variant
- 格式化库 (C++20)
- std::integer_sequence
- std::exchange
- std::make_from_tuple
- std::launder
- std::to_chars
- std::from_chars
- std::as_const
- std::source_location
- 变参数函数
- std::bitset
- std::cmp_equal, cmp_not_equal, cmp_less, cmp_greater, cmp_less_equal, cmp_greater_equal
- std::in_range
- std::declval
- std::forward
- std::move
- std::move_if_noexcept
- std::chars_format
- std::piecewise_construct_t
- std::piecewise_construct
- std::in_place, std::in_place_type, std::in_place_index, std::in_place_t, std::in_place_type_t, std::in_place_index_t
- 注释
- 类型支持（基本类型、RTTI、类型特性）
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::any::emplace
| template< class ValueType, class... Args > std::decay_t<ValueType>& emplace( Args&&... args ); |
(1) | (C++17 起) |
| template< class ValueType, class U, class... Args > std::decay_t<ValueType>& emplace( std::initializer_list<U> il, Args&&... args ); |
(2) | (C++17 起) |
更改所含对象为从参数构造的 std::decay_t<ValueType> 类型对象。
首先用 reset() 销毁当前所含对象（若存在），然后：
1) 构造从 std::forward<Args>(args)... 直接非列表初始化的 std::decay_t<ValueType> 类型对象为所含对象。此重载仅若 std::is_constructible_v<std::decay_t<ValueType>, Args...> 与 std::is_copy_constructible_v<std::decay_t<ValueType>> 皆为 true 才参与重载决议。
2) 构造从 il, std::forward<Args>(args)... 直接非列表初始化的 std::decay_t<ValueType> 类型对象所含对象。此重载仅若 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) 的要求。
| ||
返回值
到新的所含对象的引用。
异常
抛出 T 构造函数所抛的任何异常。若抛出异常，则销毁先前所含对象（若存在），而 *this 不含值。
示例
| 本节未完成 原因：暂无示例 |
参阅
构造 any 对象 (公开成员函数) | |
| 销毁所含对象 (公开成员函数) |