std::variant<Types...>::emplace
来自cppreference.com
| template <class T, class... Args> T& emplace(Args&&... args); |
(1) | (C++17 起) |
| template <class T, class U, class... Args> T& emplace( std::initializer_list<U> il, Args&&... args ); |
(2) | (C++17 起) |
| template <size_t I, class... Args> std::variant_alternative_t<I, variant>& emplace( Args&&... args ); |
(3) | (C++17 起) |
| template <size_t I, class U, class... Args> std::variant_alternative_t<I, variant>& |
(4) | (C++17 起) |
在既存的 variant 对象中原位构造新值。
1) 等价于 emplace<I>(std::forward<Args>(args)...) ，其中
I 是 T 在 Types... 中的零基下标。此重载仅若 std::is_constructible_v<T, Args...> 为 true ，且 T 在 Types... 中准确出现一次才参与重载决议。2) 等价于 emplace<I>(il, std::forward<Args>(args)...) ，其中
I 是 T 在 Types... 中的零基下标。此重载仅若 std::is_constructible_v<T, std::initializer_list<U>&, Args...> 为 true ，且 T 在 Types... 中准确出现一次才参与重载决议。3) 首先，销毁当前所含值（若存在）。然后如同以参数 std::forward<Args>(args)... 构造
T_I 类型值一般直接初始化所含值。若抛出异常，则 *this 可能变为因异常无值。此重载仅若 std::is_constructible_v<T_I, Args...> 为 true 才参与重载决议。若 I 不小于 sizeof...(Types) 则行为未定义。4) 首先，销毁当前所含值（若存在）。然后如同以参数 il, std::forward<Args>(args)... 构造
T_I 类型值一般直接初始化所含值。若抛出异常，则 *this 可能变为因异常无值。此重载仅若 std::is_constructible_v<T_I, initializer_list<U>&, Args...> 为 true 才参与重载决议。若 I 不小于 sizeof...(Types) 则行为未定义。参数
| args | - | 构造新值时使用的构造函数参数 |
| il | - | 构造新值时使用的 initializer_list 参数
|
返回值
到新的所含值的引用。
异常
1-4) 任何初始化所含值期间可能抛出的异常。
示例
运行此代码
#include <iostream> #include <string> #include <variant> int main() { std::variant<std::string> v1; v1.emplace<0>("abc"); // OK std::cout << std::get<0>(v1) << '\n'; v1.emplace<std::string>("def"); // OK std::cout << std::get<0>(v1) << '\n'; std::variant<std::string, std::string> v2; v2.emplace<1>("ghi"); // OK std::cout << std::get<1>(v2) << '\n'; // v2.emplace<std::string>("abc"); -> 错误 }
输出：
abc def ghi
参阅
赋值 variant (公开成员函数) |
