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() , затем:
- Эта перегрузка участвует в разрешении перегрузки только если std:: is_constructible_v < std:: decay_t < ValueType > , Args... > и std:: is_copy_constructible_v < std:: decay_t < ValueType >> оба true .
- Эта перегрузка участвует в разрешении перегрузки только если 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
не содержит значения.
Пример
#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"; } }; int main() { 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'} /* no args */); 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
(публичная функция-член) |
|
|
уничтожает содержащийся объект
(публичная функция-член) |