std::ranges::fill
De es.cppreference.net
| Definido en el encabezado <algorithm>
|
||
| Firma de llamada |
||
template< class T, std::output_iterator<const T&> O, std::sentinel_for<O> S >
constexpr O fill( O first, S last, const T& value );
|
(1) | (desde C++20) (hasta C++26) |
template< class O, std::sentinel_for<O> S, class T = std::iter_value_t<O> >
requires std::output_iterator<O, const T&>
constexpr O fill( O first, S last, const T& value );
|
(desde C++26) | |
template< class T, ranges::output_range<const T&> R >
constexpr ranges::borrowed_iterator_t<R> fill( R&& r, const T& value );
|
(2) | (desde C++20) (hasta C++26) |
template< class R, class T = ranges::range_value_t<R> >
requires ranges::output_range<R, const T&>
constexpr ranges::borrowed_iterator_t<R> fill( R&& r, const T& value );
|
(desde C++26) | |
1) Asigna el
value dado a los elementos en el rango [first, last).2) Igual que (1), pero usa
r como el rango fuente, como si usara ranges::begin(r) como first y ranges::end(r) como last.Las entidades similares a funciones descritas en esta página son objetos función de algoritmo (informalmente conocidos como niebloids), es decir:
- No se pueden especificar listas de argumentos de plantilla explícitas al llamar a cualquiera de ellos.
- Ninguno de ellos es visible para la búsqueda dependiente de argumentos.
- Cuando cualquiera de ellos se encuentra mediante búsqueda no calificada normal como el nombre a la izquierda del operador de llamada a función, la búsqueda dependiente de argumentos se inhibe.
Parámetros
| first, last | - | el par iterador-centinela que define el rango de elementos a modificar |
| r | - | el rango de elementos a modificar |
| value | - | el valor a asignar |
Valor de retorno
Un iterador de salida que se compara igual a last.
Complejidad
Exactamente last - first asignaciones.
Posible implementación
struct fill_fn
{
template<class O, std::sentinel_for<O> S, class T = std::iter_value_t<O>>
requires std::output_iterator<O, const T&>
constexpr O operator()(O first, S last, const T& value) const
{
while (first != last)
*first++ = value;
return first;
}
template<class R, class T = ranges::range_value_t<R>>
requires ranges::output_range<R, const T&>
constexpr ranges::borrowed_iterator_t<R> operator()(R&& r, const T& value) const
{
return (*this)(ranges::begin(r), ranges::end(r), value);
}
};
inline constexpr fill_fn fill;
|
Notas
| Macro de prueba de características | Valor | Std | Característica |
|---|---|---|---|
__cpp_lib_algorithm_default_value_type |
202403 |
(C++26) | Inicialización de lista para algoritmos (1,2) |
Ejemplo
Ejecutar este código
#include <algorithm>
#include <complex>
#include <iostream>
#include <vector>
void println(const auto& seq)
{
for (const auto& e : seq)
std::cout << e << ' ';
std::cout << '\n';
}
int main()
{
std::vector<int> v{0, 1, 2, 3, 4, 5};
// set all elements to -1 using overload (1)
std::ranges::fill(v.begin(), v.end(), -1);
println(v);
// set all element to 10 using overload (2)
std::ranges::fill(v, 10);
println(v);
std::vector<std::complex<double>> nums{{1, 3}, {2, 2}, {4, 8}};
println(nums);
#ifdef __cpp_lib_algorithm_default_value_type
std::ranges::fill(nums, {4, 2}); // T gets deduced
#else
std::ranges::fill(nums, std::complex<double>{4, 2});
#endif
println(nums);
}
Salida:
-1 -1 -1 -1 -1 -1
10 10 10 10 10 10
(1,3) (2,2) (4,8)
(4,2) (4,2) (4,2)
Véase también
(C++20) |
asigna un valor a un número de elementos (objeto función de algoritmo) |
(C++20)(C++20) |
copia un rango de elementos a una nueva ubicación (objeto función de algoritmo) |
(C++20) |
guarda el resultado de una función en un rango (objeto función de algoritmo) |
(C++20) |
aplica una función a un rango de elementos (objeto función de algoritmo) |
(C++26) |
llena un rango con números aleatorios de un generador de bits aleatorio uniforme (objeto función de algoritmo) |
| asigna por copia el valor dado a cada elemento en un rango (plantilla de función) |