std::generate_n - cppreference.com
De cppreference.com
</tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody>
| Definido en el archivo de encabezado |
||
| (1) | ||
|
|
(hasta C++11) | |
|
|
(desde C++11) (hasta C++20) |
|
|
|
(desde C++20) | |
|
|
(2) | (desde C++17) |
1) Asigna valores generados por el objeto de función dado g, a los primeros count elementos en el rango que comienza en first, si count > 0. De lo contrario no hace nada.
2) Igual que (1), pero se ejecuta de acuerdo a la política de ejecución 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.
Parámetros
| first | - | El comienzo del rango de elementos a generar. |
| count | - | El número de elementos a generar. |
| policy | - | La política de ejecución a usar. Véase política de ejecución para más detalles. |
| g | - | El objeto función generador que se llamará.
La signatura de la función debe ser equivalente a la siguiente: El tipo |
| Requisitos de tipo | ||
-OutputIt debe satisfacer los requisitos de OutputIterator.
| ||
-ForwardIt debe satisfacer los requisitos de ForwardIterator.
| ||
Valor de retorno
|
(Ninguno) |
(hasta C++11) |
|
Un iterador más allá del último elemento asignado si |
(desde C++11) |
Complejidad
Exactamente std::max(0, count) invocaciones de g() y asignaciones.
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.
Posible implementación
template<class OutputIt, class Size, class Generator> constexpr // desde C++20 OutputIt // void hasta C++11 generate_n(OutputIt first, Size count, Generator g) { for (Size i = 0; i < count; ++i, ++first) *first = g(); return first; }
Ejemplo
#include <algorithm> #include <functional> #include <iostream> #include <iterator> #include <random> int main() { std::mt19937 rng; // construido por defecto, sembrado con una semilla fija std::generate_n(std::ostream_iterator<std::mt19937::result_type>(std::cout, " "), 5, std::ref(rng)); std::cout << '\n'; }
Salida:
3499211612 581869302 3890346734 3586334585 545404204
Informes de defectos
Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.
| ID | Aplicado a | Comportamiento según lo publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 426 | C++98 | El requisito de complejidad era 'exactamente count invocacioneso asignaciones', que está roto si count es negativo.
|
Ninguna invocación o asignación si count no es positivo.
|
Véase también
| Asigna por copia el valor dado a todos los elementos de un rango. (plantilla de función) [editar] | |
| Asigna el resultado de las llamadas sucesivas de una función a todos los elementos de un rango. (plantilla de función) [editar] | |
Guarda el resultado de N aplicaciones de una función. (niebloid) [editar] |