CKTIS / C++
std::left — allineare a sinistra un campo di output
std::left seleziona l’allineamento a sinistra per l’output formattato di uno stream. Se un campo è più largo del suo valore, i caratteri di riempimento compaiono dopo il valore. L’allineamento resta attivo finché non viene modificato.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <iomanip>
#include <ios>
#include <ostream>
// Usage with an output stream:
out << std::left << std::setw(width) << value;std::left è un manipolatore dichiarato in <ios>. Scrivere out << std::left modifica lo stato di formattazione dello stream invece di stampare testo. La funzione chiama str.setf(std::ios_base::left, std::ios_base::adjustfield) e restituisce str: sostituisce l’impostazione dell’allineamento senza modificare altri gruppi di flag.
In un campo di output allineato a sinistra, i caratteri di riempimento seguono il valore. Imposta la larghezza con std::setw(width) e il carattere di riempimento con std::setfill(c); entrambi i manipolatori richiedono <iomanip>. La larghezza è un minimo: il testo più lungo non viene troncato. std::left non imposta né la larghezza né il carattere di riempimento.
L’allineamento e il carattere di riempimento restano impostati finché non vengono modificati. Al contrario, l’inserimento di un carattere o di una stringa di caratteri azzera la larghezza del campo; quindi ripeti std::setw prima di ogni campo di questo tipo. std::right sostituisce l’allineamento a sinistra con quello a destra. Se usi uno stream condiviso, ricorda che lo stato modificato influisce anche sulle operazioni di output successive.
L’esempio usa punti per rendere visibile il riempimento. I primi due campi mostrano che std::left resta attivo, mentre l’ultimo mostra il passaggio a std::right. Puoi verificare l’esempio in locale con -std=c++23. Il codice sorgente mostrato è stato eseguito senza modifiche in un ambiente isolato e l’output standard (stdout) ha coinciso esattamente con quello atteso. Questa verifica non attesta il comportamento in esecuzione in produzione.
Esempi
#include <iomanip>
#include <ios>
#include <iostream>
int main() {
std::cout << std::setfill('.') << std::left;
std::cout << '|' << std::setw(6) << "cat"
<< '|' << std::setw(6) << "ox" << "|\n";
std::cout << std::right
<< '|' << std::setw(6) << "cat" << "|\n";
}
Risultato
|cat...|ox....| |...cat|
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]