Namespaces
Variants

std::optional<T>:: emplace

From cppreference.net
C++
Utilities library
std::optional
template < class ... Args >
T & emplace ( Args && ... args ) ;
(1) (начиная с C++17)
(constexpr начиная с C++20)
template < class U, class ... Args >
T & emplace ( std:: initializer_list < U > ilist, Args && ... args ) ;
(2) (начиная с C++17)
(constexpr начиная с C++20)

Создает содержащееся значение на месте. Если * this уже содержит значение до вызова, содержащееся значение уничтожается путем вызова его деструктора.

1) Инициализирует содержащееся значение с помощью прямой инициализации (но не прямой инициализации списком) с параметрами std:: forward < Args > ( args ) ... .
2) Инициализирует содержащееся значение путем вызова его конструктора с параметрами ilist, std:: forward < Args > ( args ) ... . Эта перегрузка участвует в разрешении перегрузки только если std:: is_constructible < T, std:: initializer_list < U > & , Args && ... > :: value равно true .

Содержание

Параметры

args... - аргументы для передачи конструктору
ilist - список инициализации для передачи конструктору
Требования к типам
-
T должен быть конструируемым из Args... для перегрузки (1)
-
T должен быть конструируемым из std::initializer_list и Args... для перегрузки (2)

Возвращаемое значение

Ссылка на новое содержащееся значение.

Исключения

Любое исключение, выброшенное выбранным конструктором T . Если исключение выброшено, * this не содержит значения после этого вызова (ранее содержавшееся значение, если оно было, было уничтожено).

Макрос тестирования возможностей Значение Стандарт Функция
__cpp_lib_optional 202106L (C++20)
(DR20) 		Полностью constexpr ( 1,2 )

Пример

Запустить этот код 
#include <iostream>
#include <optional>
struct A
{
    std::string s;
    A(std::string str) : s(std::move(str)), id{n++} { note("+ constructed"); }
    ~A() { note("~ destructed"); }
    A(const A& o) : s(o.s), id{n++} { note("+ copy constructed"); }
    A(A&& o) : s(std::move(o.s)), id{n++} { note("+ move constructed"); }
    A& operator=(const A& other)
    {
        s = other.s;
        note("= copy assigned");
        return *this;
    }
    A& operator=(A&& other)
    {
        s = std::move(other.s);
        note("= move assigned");
        return *this;
    }
    inline static int n{};
    int id{};
    void note(auto s) { std::cout << "  " << s << " #" << id << '\n'; }
};
int main()
{
    std::optional<A> opt;
    std::cout << "Assign:\n";
    opt = A("Lorem ipsum dolor sit amet, consectetur adipiscing elit nec.");
    std::cout << "Emplace:\n";
    // Поскольку opt содержит значение, оно также уничтожит это значение
    opt.emplace("Lorem ipsum dolor sit amet, consectetur efficitur.");
    std::cout << "End example\n";
}

Вывод: 

Assign:
  + constructed #0
  + move constructed #1
  ~ destructed #0
Emplace:
  ~ destructed #1
  + constructed #2
End example
  ~ destructed #2

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Applied to Behavior as published Correct behavior
P2231R1 C++20 emplace не был constexpr тогда как требуемые операции могут быть constexpr в C++20 сделан constexpr

Смотрите также

присваивает содержимое
(публичная функция-член)