Partilhar via


in_place_t, in_place_type_t, in_place_index_t struct

Introduzido no C++17.

Os in_place_ttipos de marca , in_place_type_te in_place_index_t são usados para selecionar o construtor sobrecarregado que cria o objeto no local da maneira desejada. Para os tipos que usam esses tipos de tag, eles também podem ajudar a evitar operações temporárias de cópia ou movimentação.

Sintaxe

struct in_place_t
{
    explicit in_place_t() = default;
};

inline constexpr in_place_t in_place{};

template <class T>
struct in_place_type_t
{
    explicit in_place_type_t() = default;
};

template <class T>
constexpr in_place_type_t<T> in_place_type{};

template <size_t I>
struct in_place_index_t
{
    explicit in_place_index_t() = default;
};

template <size_t I>
constexpr in_place_index_t<I> in_place_index{};

Parâmetros

I
O índice em que o objeto é criado no local.

T
O tipo de objeto a ser criado.

Comentários

  • in_place_t indica a construção no local de um objeto. Usado para criar objetos no local dentro de um std::optionalarquivo .
  • in_place_type_t indica a construção no local de um objeto de um tipo específico. É útil porque std::any std::any pode conter qualquer tipo de tipo, então precisamos especificar o tipo que ele contém.
  • in_place_index_t indica a construção in-loco de um objeto em um índice específico. Use com std::variant para especificar o índice em que o objeto é criado.

Os seguintes tipos de classe usam esses structs em seus construtores: expected, optional, single_view, any ou variant.

Exemplo

#include <iostream>
#include <optional>
#include <any>
#include <variant>

// compile with /std:c++17

struct MyStruct
{
    double value;
    MyStruct(double v0, double v1 = 0) : value(v0 + v1) {}
};

int main()
{
    // Construct a MyStruct directly inside opt
    std::optional<MyStruct> opt(std::in_place, 29.0, 13.0);

    // Construct a MyStruct object inside an any object
    std::any a(std::in_place_type<MyStruct>, 3.14);

    // Construct a MyStruct object inside a vector at index 0
    std::variant<MyStruct, int> v(std::in_place_index<0>, 2.718);

    if (opt)
    {
        std::cout << opt->value << ", ";
    }

    std::cout << std::any_cast<MyStruct>(a).value << ", "
              << std::get<0>(v).value;

    return 0;
}
42, 3.14, 2.718

Requisitos

Cabeçalho: <utility>

Namespace: std

Opção do compilador: /std:c++17 ou posterior.