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.