Namespaces
Variants

std:: to_array

From es.cppreference.net
Definido en el encabezado <array>
template < class T, std:: size_t N >
constexpr std:: array < std:: remove_cv_t < T > , N > to_array ( T ( & a ) [ N ] ) ;
(1) (desde C++20)
template < class T, std:: size_t N >
constexpr std:: array < std:: remove_cv_t < T > , N > to_array ( T ( && a ) [ N ] ) ;
(2) (desde C++20)

Crea un std::array a partir del array incorporado unidimensional a . No se admite la copia o movimiento de arrays incorporados multidimensionales.

1) Para cada i en 0, ..., N - 1 , inicializa por copia el elemento correspondiente del resultado con a [ i ] . Esta sobrecarga está mal formada cuando std:: is_constructible_v < T, T & > es false .
2) Para cada i en 0, ..., N - 1 , inicializa por movimiento el elemento correspondiente del resultado con std :: move ( a [ i ] ) . Esta sobrecarga está mal formada cuando std:: is_move_constructible_v < T > es false .

Ambas sobrecargas están mal formadas cuando std:: is_array_v < T > es true .

Contenidos

Parámetros

a - el array incorporado que se convertirá en std::array
Requisitos de tipo
-
T debe cumplir con los requisitos de CopyConstructible para utilizar la sobrecarga (1).
-
T debe cumplir con los requisitos de MoveConstructible para utilizar la sobrecarga (2).

Valor de retorno

1) std:: array < std:: remove_cv_t < T > , N > { a [ 0 ] , ..., a [ N - 1 ] }
2) std:: array < std:: remove_cv_t < T > , N > { std :: move ( a [ 0 ] ) , ..., std :: move ( a [ N - 1 ] ) }

Notas

Hay algunas ocasiones en las que la deducción de argumentos de plantilla de clase de std::array no puede utilizarse mientras to_array está disponible:

  • to_array puede utilizarse cuando el tipo de elemento del std::array se especifica manualmente y la longitud se deduce, lo cual es preferible cuando se desea una conversión implícita.
  • to_array puede copiar un literal de cadena, mientras que la deducción de argumentos de plantilla de clase construye un std::array de un único puntero a su primer carácter.
std::to_array<long>({3, 4}); // OK: conversión implícita
// std::array<long>{3, 4};   // error: muy pocos argumentos de plantilla
std::to_array("foo");        // crea std::array<char, 4>{'f', 'o', 'o', '\0'}
std::array{"foo"};           // crea std::array<const char*, 1>{"foo"}
Macro de prueba de características Valor Estándar Característica
__cpp_lib_to_array 201907L (C++20) std::to_array

Implementación posible

to_array (1)
namespace detail
{
    template<class T, std::size_t N, std::size_t... I>
    constexpr std::array<std::remove_cv_t<T>, N>
        to_array_impl(T (&a)[N], std::index_sequence<I...>)
    {
        return {{a[I]...}};
    }
}
template<class T, std::size_t N>
constexpr std::array<std::remove_cv_t<T>, N> to_array(T (&a)[N])
{
    return detail::to_array_impl(a, std::make_index_sequence<N>{});
}
to_array (2)
namespace detail
{
    template<class T, std::size_t N, std::size_t... I>
    constexpr std::array<std::remove_cv_t<T>, N>
        to_array_impl(T (&&a)[N], std::index_sequence<I...>)
    {
        return {{std::move(a[I])...}};
    }
}
template<class T, std::size_t N>
constexpr std::array<std::remove_cv_t<T>, N> to_array(T (&&a)[N])
{
    return detail::to_array_impl(std::move(a), std::make_index_sequence<N>{});
}

Ejemplo

#include <array>
#include <memory>
#include <string_view>
#include <type_traits>
#include <utility>
// crea un array constexpr de string_view's    
constexpr auto w1n = std::to_array<std::string_view>({
    "Mary", "Patricia", "Linda", "Barbara", "Elizabeth", "Jennifer"
});
static_assert(std::is_same_v<decltype(w1n), const std::array<std::string_view, 6>>);
static_assert(w1n.size() == 6 and w1n[5] == "Jennifer");
int main()
{
    // copia un literal de cadena
    auto a1 = std::to_array("foo");
    static_assert(a1.size() == 4);
    // deduce tanto el tipo de elemento como la longitud
    auto a2 = std::to_array({0, 2, 1, 3});
    static_assert(std::is_same_v<decltype(a2), std::array<int, 4>>);
    // deduce longitud con tipo de elemento especificado
    // ocurre conversión implícita
    auto a3 = std::to_array<long>({0, 1, 3});
    static_assert(std::is_same_v<decltype(a3), std::array<long, 3>>);
    auto a4 = std::to_array<std::pair<int, float>>(
        {{3, 0.0f}, {4, 0.1f}, {4, 0.1e23f}});
    static_assert(a4.size() == 3);
    // crea un std::array no copiable
    auto a5 = std::to_array({std::make_unique<int>(3)});
    static_assert(a5.size() == 1);
    // error: no se admite la copia de arrays multidimensionales
    // char s[2][6] = {"nice", "thing"};
    // auto a6 = std::to_array(s);
}

Véase también

(library fundamentals TS v2)
crea un objeto std::array cuyo tamaño y opcionalmente el tipo de elemento se deducen de los argumentos
(plantilla de función)