std::fill
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 T > void fill( ForwardIt first, ForwardIt last, const T& value ); |
(hasta C++20) | |
template< class ForwardIt, class T > constexpr void fill( ForwardIt first, ForwardIt last, const T& value ); |
(desde C++20) | |
template< class ExecutionPolicy, class ForwardIt, class T > void fill( ExecutionPolicy&& policy, ForwardIt first, ForwardIt last, const T& value ); |
(2) | (desde C++17) |
1) Asigna el valor
value dado a los elementos en el rango [first, last).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 modificar. |
| value | - | El valor a asignar. |
| policy | - | La política de ejecución a usar. Véase política de ejecución para más detalles. |
| Requisitos de tipo | ||
-ForwardIt debe satisfacer los requisitos de ForwardIterator.
| ||
-value debe ser escribible para first.
| ||
Valor de retorno
(Ninguno)
Complejidad
Exactamente std::distance(first, last) 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 T>
void fill(ForwardIt first, ForwardIt last, const T& value)
{
for (; first != last; ++first)
*first = value;
}
|
Ejemplo
El siguiente código usa fill() para establecer todos los elementos de un vector std::vector<int> en -1:
Ejecuta este código
#include <algorithm>
#include <iostream>
#include <vector>
int main()
{
std::vector<int> v {0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
std::fill(v.begin(), v.end(), -1);
for (auto elem : v)
std::cout << elem << ' ';
std::cout << '\n';
}
Salida:
-1 -1 -1 -1 -1 -1 -1 -1 -1 -1
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 283 | C++98 | Se requería que T fuera CopyAssignable, peroT no siempre es escribible para ForwardIt
|
En su lugar se requiere que sea escribible. |
Véase también
| Asigna por copia el valor dado a todos los elementos de un rango. (plantilla de función) | |
(C++11) |
Copia un rango de elementos a una nueva ubicación. (plantilla de función) |
| Asigna el resultado de las llamadas sucesivas de una función a todos los elementos de un rango. (plantilla de función) | |
| Aplica una función a un rango de elementos (plantilla de función) | |
(C++20) |
Asigna un cierto valor a un rango de elementos. (niebloid) |