Condividi tramite


fill_n

Assegna un nuovo valore a un numero specificato di elementi in un intervallo a partire da un determinato elemento.

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

Parametri

  • First
    Iteratore di output destinato alla posizione del primo elemento nell'intervallo a cui deve essere assegnato il valore Val.

  • Count
    Tipo integer con segno o senza segno che specifica il numero di elementi da assegnare al valore.

  • Val
    Valore da assegnare agli elementi nell'intervallo [First, Inizio + Conteggio).

Valore restituito

Iteratore sull'elemento dopo l'ultimo elemento compilato se Count > è zero. In caso contrario, il primo elemento.

Note

L'intervallo di destinazione deve essere valido; tutti i puntatori devono essere dereferenziabili e l'ultima posizione è raggiungibile dalla prima attraverso l'incremento. La complessità è lineare con la dimensione dell'intervallo.

fill_n dispone di due form correlati:

Per informazioni sul comportamento di queste funzioni, vedere Iteratori verificati.

Esempio

// 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;
}

Output

  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 )

Requisiti

Intestazione: <algoritmo>

Spazio dei nomi: std

Vedere anche

Riferimenti

Libreria di modelli standard