std:: fill
|
Défini dans l'en-tête
<algorithm>
|
||
| (1) | ||
|
template
<
class
ForwardIt,
class
T
>
void fill ( ForwardIt first, ForwardIt last, const T & value ) ; |
(constexpr depuis C++20)
(jusqu'à C++26) |
|
|
template
<
class
ForwardIt,
class
T
=
typename
std::
iterator_traits
<
ForwardIt
>
::
value_type
>
|
(depuis C++26) | |
| (2) | ||
|
template
<
class
ExecutionPolicy,
class
ForwardIt,
class
T
>
void
fill
(
ExecutionPolicy
&&
policy,
|
(depuis C++17)
(jusqu'à C++26) |
|
|
template
<
class
ExecutionPolicy,
class
ForwardIt,
class
T
=
typename
std::
iterator_traits
|
(depuis C++26) | |
[
first
,
last
)
.
|
std:: is_execution_policy_v < std:: decay_t < ExecutionPolicy >> est true . |
(jusqu'en C++20) |
|
std:: is_execution_policy_v < std:: remove_cvref_t < ExecutionPolicy >> est true . |
(depuis C++20) |
Si value n'est pas écrivable vers first , le programme est mal formé.
Table des matières |
Paramètres
| first, last | - | la paire d'itérateurs définissant la plage d'éléments à modifier |
| value | - | la valeur à assigner |
| policy | - | la politique d'exécution à utiliser |
| Exigences de type | ||
-
ForwardIt
doit satisfaire aux exigences de
LegacyForwardIterator
.
|
||
Complexité
Exactement std:: distance ( first, last ) affectations.
Exceptions
La surcharge avec un paramètre de modèle nommé
ExecutionPolicy
signale les erreurs comme suit :
-
Si l'exécution d'une fonction invoquée dans le cadre de l'algorithme lève une exception et que
ExecutionPolicyfait partie des politiques standard , std::terminate est appelé. Pour tout autreExecutionPolicy, le comportement est défini par l'implémentation. - Si l'algorithme ne parvient pas à allouer de la mémoire, std::bad_alloc est levé.
Implémentation possible
| fill (1) |
|---|
template<class ForwardIt, class T = typename std::iterator_traits<ForwardIt>::value_type> void fill(ForwardIt first, ForwardIt last, const T& value) { for (; first != last; ++first) *first = value; } |
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, 6, 7, 8}; println(v); // définir tous les éléments à 8 std::fill(v.begin(), v.end(), 8); println(v); std::vector<std::complex<double>> nums{{1, 3}, {2, 2}, {4, 8}}; println(nums); #ifdef __cpp_lib_algorithm_default_value_type std::fill(nums.begin(), nums.end(), {4, 2}); #else std::fill(nums.begin(), nums.end(), std::complex<double>{4, 2}); #endif println(nums); }
Sortie :
0 1 2 3 4 5 6 7 8 8 8 8 8 8 8 8 8 8 (1,3) (2,2) (4,8) (4,2) (4,2) (4,2)
Rapports de défauts
Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.
| DR | Appliqué à | Comportement tel que publié | Comportement corrigé |
|---|---|---|---|
| LWG 283 | C++98 |
T
devait être
CopyAssignable
, mais
T
n'est pas toujours inscriptible dans
ForwardIt
|
requis d'être inscriptible à la place |
Voir aussi
|
assigne par copie la valeur donnée à N éléments dans une plage
(modèle de fonction) |
|
|
(C++11)
|
copie une plage d'éléments vers un nouvel emplacement
(modèle de fonction) |
|
assigne les résultats d'appels successifs de fonction à chaque élément d'une plage
(modèle de fonction) |
|
|
applique une fonction à une plage d'éléments, stockant les résultats dans une plage de destination
(modèle de fonction) |
|
|
(C++20)
|
assigne une certaine valeur à une plage d'éléments
(objet fonction d'algorithme) |