Namespaces
Variants

std::ranges:: fill

From cppreference.net
Algorithm library
Constrained algorithms and algorithms on ranges (C++20)
Constrained algorithms, e.g. ranges::copy , ranges::sort , ...
Execution policies (C++17)
Non-modifying sequence operations
Batch operations
(C++17)
Search operations
Modifying sequence operations
Copy operations
(C++11)
(C++11)
Swap operations
Transformation operations
Generation operations
Removing operations
Order-changing operations
(until C++17) (C++11)
(C++20) (C++20)
Sampling operations
(C++17)

Sorting and related operations
Partitioning operations
Sorting operations
Binary search operations
(on partitioned ranges)
Set operations (on sorted ranges)
Merge operations (on sorted ranges)
Heap operations
Minimum/maximum operations
Lexicographical comparison operations
Permutation operations
C library
Numeric operations
Operations on uninitialized memory
Constrained algorithms
All names in this menu belong to namespace std::ranges
Non-modifying sequence operations
Modifying sequence operations
Partitioning operations
Sorting operations
Binary search operations (on sorted ranges)
Set operations (on sorted ranges)
Heap operations
Minimum/maximum operations
Permutation operations
Fold operations
Operations on uninitialized storage
Return types
Défini dans l'en-tête <algorithm>
Signature d'appel
(1)
template < class T, std:: output_iterator < const T & > O, std:: sentinel_for < O > S >
constexpr O fill ( O first, S last, const T & value ) ;
(depuis C++20)
(jusqu'à 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 ) ;
(depuis C++26)
(2)
template < class T, ranges:: output_range < const T & > R >
constexpr ranges:: borrowed_iterator_t < R > fill ( R && r, const T & value ) ;
(depuis C++20)
(jusqu'à 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 ) ;
(depuis C++26)
1) Affecte la value donnée aux éléments dans la plage [ first , last ) .
2) Identique à (1) , mais utilise r comme plage source, comme si on utilisait ranges:: begin ( r ) comme first et ranges:: end ( r ) comme last .

Les entités de type fonction décrites sur cette page sont des objets fonction d'algorithme (informellement appelés niebloids ), c'est-à-dire :

Table des matières

Paramètres

first, last - la paire itérateur-sentinelle définissant la plage des éléments à modifier
r - la plage des éléments à modifier
value - la valeur à assigner

Valeur de retour

Un itérateur de sortie qui compare égal à last .

Complexité

Exactement last - first affectations.

Implémentation possible

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;

Notes

Macro de test de fonctionnalité Valeur Std Fonctionnalité
__cpp_lib_algorithm_default_value_type 202403 (C++26) Initialisation par liste pour les algorithmes ( 1,2 )

Exemple

#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};
    // définir tous les éléments à -1 en utilisant la surcharge (1)
    std::ranges::fill(v.begin(), v.end(), -1);
    println(v);
    // définir tous les éléments à 10 en utilisant la surcharge (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 est déduit
    #else
        std::ranges::fill(nums, std::complex<double>{4, 2});
    #endif
    println(nums);
}

Sortie :

-1 -1 -1 -1 -1 -1
10 10 10 10 10 10
(1,3) (2,2) (4,8)
(4,2) (4,2) (4,2)

Voir aussi

assigne une valeur à un certain nombre d'éléments
(objet fonction algorithme)
copie une plage d'éléments vers un nouvel emplacement
(objet fonction algorithme)
sauvegarde le résultat d'une fonction dans une plage
(objet fonction algorithme)
applique une fonction à une plage d'éléments
(objet fonction algorithme)
remplit une plage avec des nombres aléatoires d'un générateur de bits aléatoire uniforme
(objet fonction algorithme)
assigne par copie la valeur donnée à chaque élément d'une plage
(modèle de fonction)