CKTIS / C++
std::setw — impostare la larghezza del campo di uno stream
std::setw(n), dichiarato in <iomanip>, imposta la larghezza del campo di uno stream. In uscita, i valori più brevi vengono riempiti e quelli più lunghi non vengono troncati. Reimposta la larghezza per i campi successivi, perché le operazioni di output possono azzerarla.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) è un manipolatore dichiarato in <iomanip>. Usato come out << std::setw(n) o in >> std::setw(n), richiama di fatto width(n) sullo stream interessato. Accetta un int e restituisce un oggetto di tipo non specificato, non la larghezza stessa. In input, il significato dell’impostazione dipende dall’operazione di estrazione; non è un limite generale al numero di cifre.
In output, la larghezza indica la dimensione minima del campo per le operazioni che la rispettano. Una rappresentazione più breve riceve caratteri di riempimento; una più lunga viene scritta per intero. std::setfill sceglie il carattere di riempimento, mentre std::left e std::right consentono di allineare il testo rispettivamente a sinistra e a destra.
Non considerare la larghezza un’impostazione permanente della colonna. Le operazioni di inserimento di caratteri e stringhe di caratteri la azzerano dopo l’uso; inserisci quindi std::setw(n) subito prima di ogni campo da riempire. Anche un separatore inserito prima del valore previsto può consumare la larghezza. Impostare soltanto il riempimento o l’allineamento non la consuma; queste impostazioni restano attive finché non vengono modificate.
Nell’esempio, cat riceve due punti a sinistra, x non viene riempito e dog riceve due punti a destra. bird resta completo nonostante la larghezza 2. std::setw è definito nella sezione [std.manip]. Il documento citato è una bozza di lavoro, non una pubblicazione definitiva di C++23.
Esempi
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
out << std::setfill('.') << std::right;
out << '|' << std::setw(5) << "cat" << '|' << "x" << '|';
out << std::left << std::setw(5) << "dog" << '|';
out << std::setw(2) << "bird" << '|';
std::cout << out.str() << '\n';
}
Risultato
|..cat|x|dog..|bird|
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.