Namespaces
Variants

    std::any::emplace

    From ru.cppreference.net
     
    C++
    Поддержка компиляторов
    Автономное и hosted окружение
    Язык
    Стандартная библиотека
    Заголовки стандартной библиотеки
    Именованные требования
    Макросы тестирования возможностей (C++20)
    Библиотека поддержки языка
    Библиотека концептов (C++20)
    Библиотека диагностики
    Библиотека управления памятью
    Библиотека метапрограммирования (C++11)
    Библиотека общих утилит
    Библиотека контейнеров
    Библиотека итераторов
    Библиотека диапазонов (C++20)
    Библиотека алгоритмов
    Библиотека строк
    Библиотека обработки текста
    Библиотека численных методов
    Библиотека даты и времени
    Библиотека ввода/вывода
    Библиотека файловой системы (C++17)
    Библиотека поддержки параллелизма (C++11)
    Библиотека управления выполнением (C++26)
    Технические спецификации
    Индекс символов
    Внешние библиотеки
     
    Библиотека утилит
    Поддержка языка
    Поддержка типов (базовые типы, RTTI)
    Макросы тестирования возможностей библиотеки (C++20)
    Утилиты программ
    Функции с переменным числом аргументов
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Поддержка корутин (C++20)
    Поддержка контрактов (C++26)
    Трёхстороннее сравнение
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    Общие утилиты
    Операторы отношений (устарело в C++20)
     
    std::any
     
    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::decay_t<ValueType>, прямо, а не из списка инициализированный из std::forward<Args>(args)..., как содержащийся объект.
    • Эта перегрузка участвует в разрешении перегрузки только если std::is_constructible_v<std::decay_t<ValueType>, Args...> и std::is_copy_constructible_v<std::decay_t<ValueType>> оба удовлетворяют true.
    2) создаёт объект типа std::decay_t<ValueType>, прямо, а не из списка инициализированный из il, std::forward<Args>(args)..., как содержащийся объект.
    • Эта перегрузка участвует в разрешении перегрузки только если 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
    (публичная функция-член)
    		уничтожает содержащийся объект
    (публичная функция-член)