std:: copy_n
|
Definido en el encabezado
<algorithm>
|
||
|
template
<
class
InputIt,
class
Size,
class
OutputIt
>
OutputIt copy_n ( InputIt first, Size count, OutputIt result ) ; |
(1) |
(desde C++11)
(constexpr desde C++20) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
Size,
class
ForwardIt2
>
|
(2) | (desde C++17) |
[
0
,
count
)
, ejecuta
*
(
result
+
i
)
=
*
(
first
+
i
)
.
|
std:: is_execution_policy_v < std:: decay_t < ExecutionPolicy >> es true . |
(hasta C++20) |
|
std:: is_execution_policy_v < std:: remove_cvref_t < ExecutionPolicy >> es true . |
(desde C++20) |
Contenidos |
Parámetros
| first | - | inicio del rango de elementos a copiar |
| count | - | número de elementos a copiar |
| result | - | inicio del rango de destino |
| policy | - | la política de ejecución a utilizar |
| Requisitos de tipo | ||
-
InputIt
debe cumplir con los requisitos de
LegacyInputIterator
.
|
||
-
OutputIt
debe cumplir con los requisitos de
LegacyOutputIterator
.
|
||
-
ForwardIt1, ForwardIt2
debe cumplir con los requisitos de
LegacyForwardIterator
.
|
||
Valor de retorno
Iterador en el rango de destino, que apunta más allá del último elemento copiado si count > 0 o result en caso contrario.
Complejidad
Cero asignaciones si count < 0 ; count asignaciones en caso contrario.
Excepciones
La sobrecarga con un parámetro de plantilla llamado
ExecutionPolicy
reporta errores de la siguiente manera:
-
Si la ejecución de una función invocada como parte del algoritmo lanza una excepción y
ExecutionPolicyes uno de los standard policies , std::terminate es llamado. Para cualquier otroExecutionPolicy, el comportamiento está definido por la implementación. - Si el algoritmo falla al asignar memoria, std::bad_alloc es lanzado.
Implementación posible
template<class InputIt, class Size, class OutputIt> constexpr //< desde C++20 OutputIt copy_n(InputIt first, Size count, OutputIt result) { if (count > 0) { *result = *first; ++result; for (Size i = 1; i != count; ++i, (void)++result) *result = *++first; } return result; } |
Ejemplo
#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
Véase también
|
(C++11)
|
copia un rango de elementos a una nueva ubicación
(function template) |
|
(C++20)
|
copia un número de elementos a una nueva ubicación
(algorithm function object) |