CKTIS / C++
std::left — zarovnání výstupního pole doleva
std::left nastaví zarovnání formátovaného výstupu proudu doleva. Je-li pole širší než jeho hodnota, znaky výplně se zobrazí za hodnotou. Nastavení zarovnání zůstává aktivní, dokud se nezmění.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <iomanip>
#include <ios>
#include <ostream>
// Usage with an output stream:
out << std::left << std::setw(width) << value;std::left je manipulátor deklarovaný v <ios>. Zápis out << std::left mění stav formátování proudu, místo aby vypisoval text. Funkce volá str.setf(std::ios_base::left, std::ios_base::adjustfield) a vrací str: nahrazuje nastavení zarovnání, aniž mění jiné skupiny příznaků.
V doleva zarovnaném výstupním poli následují znaky výplně za hodnotou. Šířku nastavte pomocí std::setw(width) a znak výplně pomocí std::setfill(c); oba manipulátory vyžadují <iomanip>. Šířka je minimální: delší text se nezkracuje. std::left samo nenastavuje šířku ani znak výplně.
Zarovnání a znak výplně zůstávají nastavené, dokud se nezmění. Naproti tomu vložení znaku nebo řetězce znaků vynuluje šířku pole, proto před každým takovým polem znovu použijte std::setw. std::right nahrazuje zarovnání doleva zarovnáním doprava. Při použití sdíleného proudu mějte na paměti, že změněný stav ovlivňuje i pozdější výstupní operace.
Příklad používá tečky, aby bylo vyplnění viditelné. První dvě pole ukazují, že std::left zůstává aktivní, a poslední ukazuje přepnutí na std::right. Příklad můžete ověřit lokálně s přepínačem -std=c++23. Zobrazený zdrojový kód byl spuštěn beze změn v izolovaném prostředí a standardní výstup (stdout) přesně odpovídal očekávanému výstupu. Toto ověření nepotvrzuje chování programu za běhu v produkčním prostředí.
Příklady
#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";
}
Výsledek
|cat...|ox....| |...cat|
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
Zdroje
- 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]