std::copy_n
De cppreference.com
| Definido en el archivo de encabezado <algorithm>
|
||
| (1) | ||
| template< class InputIt, class Size, class OutputIt > OutputIt copy_n( InputIt first, Size count, OutputIt result ); |
(desde C++11) (hasta C++20) |
|
| template< class InputIt, class Size, class OutputIt > constexpr OutputIt copy_n( InputIt first, Size count, OutputIt result ); |
(desde C++20) | |
| template< class ExecutionPolicy, class ForwardIt1, class Size, class ForwardIt2 > ForwardIt2 copy_n( ExecutionPolicy&& policy, |
(2) | (desde C++17) |
1) Copia exactamente count valores del rango que comienza en first al rango que comienza en result. Formalmente, para cada entero 0 ≤ i < count, realiza *(result + i) = *(first + i). Formalmente, se permite la superposición de rangos, pero conlleva a un orden impredecible del resultado.
2) Lo mismo que (1), pero ejecutado de acuerdo a la política 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 inicio del rango de elementos del cual copiar. |
| count | - | Número de elementos a copiar. |
| result | - | El inicio 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.
| ||
-OutputIt debe satisfacer los requisitos de OutputIterator.
| ||
-ForwardIt1, ForwardIt2 debe satisfacer los requisitos de ForwardIterator.
| ||
[editar] Valor de retorno
Un iterador en el rango destino que apunta después del último elemento copiado si count > 0; de lo contrario, result.
[editar] Complejidad
Cero asignaciones si count < 0; de lo contrario, count asignaciones.
[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 OutputIt> constexpr //< since C++20 OutputIt copy_n(InputIt first, Size count, OutputIt result) { if (count > 0) { *result = *first; ++result; for (Size i = 1; i != count; ++i, ++result) *result = *++first; } return result; } |
[editar] Ejemplo
Ejecuta este código
#include <algorithm> #include <iostream> #include <iterator> #include <numeric> #include <string> #include <vector> int main() { std::string in {"1234567890"}; std::string out; std::copy_n(in.begin(), 4, std::back_inserter(out)); std::cout << out << '\n'; std::vector<int> v_in(128); std::iota(v_in.begin(), v_in.end(), 1); std::vector<int> v_out(v_in.size()); std::copy_n(v_in.cbegin(), 100, v_out.begin()); std::cout << std::accumulate(v_out.begin(), v_out.end(), 0) << '\n'; }
Salida:
1234 5050
[editar] Véase también
| (C++11) |
Copia un rango de elementos a una nueva ubicación. (plantilla de función) |
| (C++20) |
Copia un número de elementos a una nueva ubicación. (niebloid) |
