std::variant<Types...>::emplace

来自cppreference.com
< cpp‎ | utility‎ | variant
 
 
 
 
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>& emplace(std::initializer_list<U> il, Args&&... args);
(4) (C++17 起)

在既存的 variant 对象中原位构造新值。

1) 等价于 emplace<I>(std::forward<Args>(args)...) ,其中 ITTypes... 中的零基下标。此重载仅若 std::is_constructible_v<T, Args...>true ,且 TTypes... 中准确出现一次才参与重载决议。
2) 等价于 emplace<I>(il, std::forward<Args>(args)...) ,其中 ITTypes... 中的零基下标。此重载仅若 std::is_constructible_v<T, std::initializer_list<U>&, Args...>true ,且 TTypes... 中准确出现一次才参与重载决议。
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
(公开成员函数) [编辑]