fill_n

Article
06/09/2015

Assigne une nouvelle valeur à un nombre spécifié d'éléments dans une plage qui commence par un élément particulier.

template<class OutputIterator, class Size, class Type> 
   OutputIterator fill_n( 
      OutputIterator First,  
      Size Count,  
      const Type& Val 
   );

Paramètres

First
Itérateur de sortie adressant la position du premier élément de la plage à recevoir la valeur Val.
Count
Un type d'entier signé ou non signé spécifiant le nombre d'éléments à assigner à la valeur.
Val
La valeur à assigner aux éléments de la plage [First, First + Count).

Valeur de retour

Itérateur de l'élément qui suit le dernier élément fourni si Count > zéro, sinon, le premier élément.

Notes

La plage de destination doit être valide ; tous les pointeurs doivent être deréférençables, et la dernière position est accessible à partir de la première par incrémentation. La complexité est linéaire avec la taille de la plage.

fill_n a deux formulaires connexes :

Pour plus d'informations sur le comportement de ces fonctions, consultez Itérateurs vérifiés.

Exemple

// alg_fill_n.cpp
// compile using /EHsc
#include <vector>
#include <algorithm>
#include <iostream>

int main() 
{
    using namespace std;
    vector <int> v;

    for ( auto i = 0 ; i < 9 ; ++i )
        v.push_back( 0 );

    cout << "  vector v = ( " ;
    for ( const auto &w : v )
        cout << w << " ";
    cout << ")" << endl;

    // Fill the first 3 positions with a value of 1, saving position.
    auto pos = fill_n( v.begin(), 3, 1 );

    cout << "modified v = ( " ;
    for ( const auto &w : v )
        cout << w << " ";
    cout << ")" << endl;

    // Fill the next 3 positions with a value of 2, using last position.
    fill_n( pos, 3, 2 );

    cout << "modified v = ( " ;
    for ( const auto &w : v )
        cout << w << " ";
    cout << ")" << endl;

    // Fill the last 3 positions with a value of 3, using relative math.
    fill_n( v.end()-3, 3, 3 );

    cout << "modified v = ( " ;
    for ( const auto &w : v )
        cout << w << " ";
    cout << ")" << endl;
}

Sortie

  vector v = ( 0 0 0 0 0 0 0 0 0 )
modified v = ( 1 1 1 0 0 0 0 0 0 )
modified v = ( 1 1 1 2 2 2 0 0 0 )
modified v = ( 1 1 1 2 2 2 3 3 3 )

Configuration requise

En-tête : <algorithme>

Espace de noms : std

Voir aussi

Référence

Bibliothèque STL (Standard Template Library)

Partager via