std::generate
De cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| Definido en el archivo de encabezado <algorithm>
|
||
| (1) | ||
template< class ForwardIt, class Generator > void generate( ForwardIt first, ForwardIt last, Generator g ); |
(hasta C++20) | |
template< class ForwardIt, class Generator > constexpr void generate( ForwardIt first, ForwardIt last, Generator g ); |
(desde C++20) | |
template< class ExecutionPolicy, class ForwardIt, class Generator > void generate( ExecutionPolicy&& policy, ForwardIt first, ForwardIt last, Generator g ); |
(2) | (desde C++17) |
1) Asigna a cada elemento del rango
[first, last) un valor generado por el objeto función dado g.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, last | - | El rango de los 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: <tbody> </tbody>
El tipo | ||||||
| Requisitos de tipo | ||||||||
-ForwardIt debe satisfacer los requisitos de ForwardIterator.
| ||||||||
Valor de retorno
(Ninguno)
Complejidad
Exactamente std::distance(first, last) 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 ForwardIt, class Generator>
constexpr //< desde C++20
void generate(ForwardIt first, ForwardIt last, Generator g)
{
for (; first != last; ++first)
*first = g();
}
|
Ejemplo
Ejecuta este código
#include <algorithm>
#include <iostream>
#include <vector>
void println(std::string_view fmt, auto const& v)
{
for (std::cout << fmt; auto const& e : v)
std::cout << e << ' ';
std::cout << '\n';
};
int f()
{
static int i;
return ++i;
}
int main()
{
std::vector<int> v(5);
std::generate(v.begin(), v.end(), f);
println("v: ", v);
// Inicializar con valores predeterminados 0,1,2,3,4 desde una función lambda
// Equivalente a std::iota(v.begin(), v.end(), 0);
std::generate(v.begin(), v.end(), [n = 0] () mutable { return n++; });
println("v: ", v);
}
Salida:
v: 1 2 3 4 5
v: 0 1 2 3 4
Véase también
| Asigna por copia el valor dado a todos los elementos de un rango. (plantilla de función) | |
| Asigna el resultado de las llamadas sucesivas de una función a n elementos de un rango. (plantilla de función) | |
(C++11) |
Llena un rango con incrementos sucesivos del mismo valor de partida (plantilla de función) |
(C++20) |
Guarda el resultado de una función en un rango. (niebloid) |