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_arraypuede utilizarse cuando el tipo de elemento delstd::arrayse especifica manualmente y la longitud se deduce, lo cual es preferible cuando se desea una conversión implícita. -
to_arraypuede copiar un literal de cadena, mientras que la deducción de argumentos de plantilla de clase construye unstd::arrayde 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
Ejecutar este código
#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) |