CKTIS / C++
std::right — allineare a destra un campo di output
std::right imposta l’allineamento a destra in uno stream di output: i caratteri di riempimento precedono il valore. L’impostazione persiste, mentre la larghezza del campo si specifica separatamente, per esempio con std::setw.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <ios>
std::ios_base& std::right(std::ios_base& str);
// Usage: out << std::right << std::setw(width) << value;std::right è un manipolatore dichiarato in <ios>, usato come out << std::right. Chiama str.setf(std::ios_base::right, std::ios_base::adjustfield) e restituisce un riferimento allo stesso stream. Sostituisce l’impostazione precedente del gruppo adjustfield, come std::left o std::internal, senza modificare gli altri gruppi di flag.
Se la larghezza del campo supera la lunghezza della rappresentazione in output, i caratteri di riempimento vengono aggiunti prima di essa. std::right non imposta né la larghezza né il carattere di riempimento: a questo scopo si usano rispettivamente std::setw e std::setfill di <iomanip>. La larghezza è un minimo, non un limite che tronca il testo.
L’allineamento resta impostato finché i flag non vengono modificati. Al contrario, l’inserimento di un carattere o di una stringa di caratteri azzera la larghezza del campo; quindi, prima di ogni campo di questo tipo che richiede riempimento, usare di nuovo std::setw. Non confondere l’impostazione persistente dell’allineamento con la larghezza di un singolo campo.
L’esempio imposta il punto come carattere di riempimento e scrive due stringhe in campi di larghezza 5. I separatori | mostrano i confini dei campi; il risultato atteso è |..cat|...ox| seguito da un carattere di nuova riga.
Esempi
#include <iomanip>
#include <ios>
#include <iostream>
int main() {
std::cout << std::setfill('.') << std::right;
std::cout << '|' << std::setw(5) << "cat"
<< '|' << std::setw(5) << "ox" << "|\n";
}
Risultato
|..cat|...ox|
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
- C++ working draft — adjustfield manipulators [adjustfield.manip]
- C++ working draft — Header <ios> synopsis [ios.syn]
- C++ working draft — Common requirements [ostream.formatted.reqmts]
- C++ working draft — Character inserter function templates [ostream.inserters.character]
- C++ working draft — Standard manipulators [std.manip]