CKTIS / C++
std::left — wyrównanie pola wyjściowego do lewej
std::left ustawia wyrównanie do lewej dla formatowanego wyjścia strumienia. Gdy pole jest szersze od wartości, znaki wypełnienia pojawiają się po niej. Ustawienie pozostaje aktywne, dopóki nie zostanie zmienione.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <iomanip>
#include <ios>
#include <ostream>
// Usage with an output stream:
out << std::left << std::setw(width) << value;std::left to manipulator zadeklarowany w <ios>. Zapis out << std::left zmienia stan formatowania strumienia, a nie wypisuje tekstu. Funkcja wywołuje str.setf(std::ios_base::left, std::ios_base::adjustfield) i zwraca str: zastępuje ustawienie wyrównania, nie zmieniając pozostałych grup flag.
W polu wyjściowym wyrównanym do lewej znaki wypełnienia trafiają za wartość. Ustaw szerokość przez std::setw(width), a znak wypełnienia przez std::setfill(c); oba manipulatory wymagają <iomanip>. Szerokość jest minimalna: dłuższy tekst nie zostaje obcięty. Samo std::left nie ustawia szerokości ani znaku wypełnienia.
Wyrównanie i znak wypełnienia pozostają ustawione do ich zmiany. Natomiast wypisanie znaku lub łańcucha znaków zeruje szerokość pola, więc przed każdym takim polem ponów std::setw. std::right zastępuje wyrównanie do lewej wyrównaniem do prawej. Przy korzystaniu ze współdzielonego strumienia pamiętaj, że zmieniony stan wpływa także na późniejsze operacje wyjściowe.
Przykład używa kropek, aby wypełnienie było widoczne. Dwa pierwsze pola pokazują trwałość std::left, a ostatnie — zmianę na std::right. Przykład można sprawdzić lokalnie z flagą -std=c++23. Wyświetlony kod uruchomiono bez zmian w odizolowanym środowisku, a standardowe wyjście (stdout) dokładnie odpowiadało oczekiwanemu wynikowi. Ta weryfikacja nie potwierdza zachowania programu podczas działania w środowisku produkcyjnym.
Przykłady
#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";
}
Wynik
|cat...|ox....| |...cat|
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- 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]