Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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