Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::setfill — carattere di riempimento dei campi in output

std::setfill di <iomanip> imposta il carattere usato per riempire i campi durante l’output formattato. Funziona insieme a una larghezza di campo, per esempio quella impostata da std::setw, e resta attivo finché non viene modificato.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <iomanip>
// Declaration (unspecified denotes an unspecified return type):
template<class charT> unspecified setfill(charT c);
// Usage:
out << std::setfill(c);

std::setfill(c) è un manipolatore di <iomanip>. L’espressione out << std::setfill(c) modifica lo stato dello stream come se venisse chiamato out.fill(c); non scrive caratteri di per sé. La funzione restituisce un oggetto di tipo non specificato, mentre l’espressione completa con << restituisce un riferimento a out, consentendo di concatenare le operazioni.

Quando l’output formattato deve essere riempito per raggiungere la larghezza del campo, lo stream usa il carattere impostato. std::setw(n) specifica una larghezza minima, non un limite di lunghezza: il testo più lungo non viene troncato. Per il testo, std::right colloca il riempimento prima del contenuto e std::left dopo. std::setfill da solo non imposta né la larghezza né l’allineamento.

Il carattere di riempimento resta impostato per le operazioni successive, mentre l’inserimento di caratteri e stringhe azzera la larghezza del campo. Ripeti quindi std::setw prima di ogni campo da riempire. Se uno stream è condiviso, salva il carattere precedente con out.fill() e ripristinalo con out.fill(previous); questo non ripristina le altre impostazioni di formattazione.

Il tipo di c deve corrispondere al tipo di carattere dello stream: usa, per esempio, '.' per uno stream char e L'.' per uno wchar_t. L’esempio mostra la persistenza del carattere di riempimento ed entrambe le direzioni di allineamento. La specifica di std::setfill si trova nella sezione [std.manip] della bozza dello standard C++.

Esempi

#include <iomanip>
#include <iostream>
#include <sstream>

int main() {
    std::ostringstream out;
    const char previous = out.fill();

    out << std::setfill('.') << std::right
        << std::setw(5) << "A" << '|'
        << std::setw(5) << "BC" << '|'
        << std::left << std::setw(5) << "D";

    out.fill(previous);
    std::cout << out.str() << '\n';
}

Risultato

....A|...BC|D....

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti