std::any::emplace

< cpp‎ | utility‎ | any
 
C++
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
(C++14)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
(C++17)
 
std::any
成员函数
修改器
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> 类型对象为所含对象。
2) 构造从 il, std::forward<Args>(args)... 直接非列表初始化的 std::decay_t<ValueType> 类型对象所含对象。

模板形参

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

返回值

到新的所含对象的引用。

异常

抛出 T 构造函数所抛的任何异常。若抛出异常，则销毁先前所含对象（若存在），而 *this 不含值。

示例

运行此代码
#include <algorithm>
#include <any>
#include <iostream>
#include <string>
#include <vector>
 
class Star
{
    std::string name;
    int id;
 
public:
    Star(std::string name, int id) : name { name }, id { id }
    {
        std::cout << "Star::Star(string, int)\n";
    }
 
    void print() const
    {
        std::cout << "Star{ \"" << name << "\" : " << id << " };\n";
    }
};
 
auto main() -> int
{
    std::any celestial;
    // (1) emplace( Args&&... args );
    celestial.emplace<Star>("Procyon", 2943);
    const auto* star = std::any_cast<Star>(&celestial);
    star->print();
 
    std::any av;
    // (2) emplace( std::initializer_list<U> il, Args&&... args );
    av.emplace<std::vector<char>>({ 'C', '+', '+', '1', '7' } /* 无参数 */ );
    std::cout << av.type().name() << '\n';
    const auto* va = std::any_cast<std::vector<char>>(&av);
    std::for_each(va->cbegin(), va->cend(), [](char const& c) { std::cout << c; });
    std::cout << '\n';
}

可能的输出： 

Star::Star(string, int)
Star{ "Procyon" : 2943 };
St6vectorIcSaIcEE
C++17

参阅

构造 any 对象
(公开成员函数)
销毁所含对象
(公开成员函数)