std::uninitialized_copy_n
De cppreference.com
Definido en el archivo de encabezado <memory>
|
||
template< class InputIt, class Size, class NoThrowForwardIt > NoThrowForwardIt uninitialized_copy_n( InputIt first, Size count, NoThrowForwardIt d_first ); |
(1) | (desde C++11) |
template< class ExecutionPolicy, class ForwardIt, class Size, class NoThrowForwardIt > NoThrowForwardIt uninitialized_copy_n( ExecutionPolicy&& policy, ForwardIt first, Size count, |
(2) | (desde C++17) |
1) Copia
count
elementos de un rango que comienza en first
a un área de memoria no inicializada que comienza en d_first
como si fuera por
for ( ; n > 0; ++d_first, (void) ++first, --n) ::new (/*VOIDIFICAR*/(*d_first)) typename std::iterator_traits<NoThrowForwardIt>::value_type(*first);
donde /*VOIDIFICAR*/(e) es:
|
(hasta C++20) |
|
(desde C++20) |
Si se lanza una excepción durante la inicialización, los objetos ya construidos se destruyen en un orden no especificado.
2) Igual que (1), pero ejecutado de acuerdo con
policy
. Esta sobrecarga no participa en la resolución de sobrecarga a menos que std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> (hasta C++20) std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>> (desde C++20) sea verdadera.Contenido |
[editar] Parámetros
first | - | El comienzo del rango de los elementos a copiar. |
count | - | El número de elementos a copiar. |
d_first | - | El comienzo del rango de destino. |
policy | - | La política de ejecución a usar. Véase política de ejecución para más detalles. |
Requisitos de tipo | ||
-InputIt debe satisfacer los requisitos de InputIterator.
| ||
-ForwardIt debe satisfacer los requisitos de ForwardIterator.
| ||
-NoThrowForwardIt debe satisfacer los requisitos de ForwardIterator.
| ||
-Ningún incremento, asignación, comparación o direccionamiento indirecto a través de instancias válidas de NoThrowForwardIt puede lanzar excepciones.
|
[editar] Valor de retorno
Iterador al elemento más allá del último elemento copiado.
[editar] Complejidad
Lineal en count
.
[editar] Excepciones
La sobrecarga con un parámetro de plantilla llamado ExecutionPolicy
(política de ejecución) reporta errores tales que:
- Si la ejecución de una función invocada como parte del algoritmo lanza una excepción y la política de ejecución es una de las tres políticas estándar, se llama a std::terminate. Para cualquier otra política de ejecución, el comportamiento está definido por la implementación.
- Si el algoritmo falla al asignar memoria, se lanza std::bad_alloc.
[editar] Posible implementación
template<class InputIt, class Size, class NoThrowForwardIt> NoThrowForwardIt uninitialized_copy_n(InputIt first, Size count, NoThrowForwardIt d_first) { using T = typename std::iterator_traits<NoThrowForwardIt>::value_type; NoThrowForwardIt current = d_first; try { for (; count > 0; ++first, (void) ++current, --count) { ::new (const_cast<void*>(static_cast<const volatile void*>( std::addressof(*current)))) T(*first); } } catch (...) { for (; d_first != current; ++d_first) { d_first->~T(); } throw; } return current; } |
[editar] Ejemplo
Ejecuta este código
#include <algorithm> #include <iostream> #include <memory> #include <string> #include <tuple> #include <vector> int main() { std::vector<std::string> v = {"Este", "es", "un", "ejemplo"}; std::string* p; std::size_t sz; std::tie(p, sz) = std::get_temporary_buffer<std::string>(v.size()); sz = std::min(sz, v.size()); std::uninitialized_copy_n(v.begin(), sz, p); for (std::string* i = p; i != p+sz; ++i) { std::cout << *i << ' '; i->~basic_string<char>(); } std::return_temporary_buffer(p); }
Salida:
Este es un ejemplo
[editar] Véase también
Copia un rango de objetos a una zona de memoria sin inicializar. (plantilla de función) | |
(C++20) |
Copia un número de objetos a un área de memoria sin inicializar. (niebloid) |