CKTIS / C++
std::left — zarovnanie výstupného poľa doľava
std::left nastaví zarovnanie formátovaného výstupu prúdu doľava. Ak je pole širšie než jeho hodnota, znaky výplne sa zobrazia za hodnotou. Nastavenie zarovnania zostáva aktívne, kým sa nezmení.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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 mení stav formátovania prúdu namiesto vypisovania textu. Funkcia volá str.setf(std::ios_base::left, std::ios_base::adjustfield) a vracia str: nahrádza nastavenie zarovnania bez zmeny ostatných skupín príznakov.
V doľava zarovnanom výstupnom poli nasledujú znaky výplne za hodnotou. Šírku nastavte pomocou std::setw(width) a znak výplne pomocou std::setfill(c); oba manipulátory vyžadujú <iomanip>. Šírka je minimálna: dlhší text sa neskracuje. std::left samo nenastavuje šírku ani znak výplne.
Zarovnanie a znak výplne zostávajú nastavené, kým sa nezmenia. Naopak, vloženie znaku alebo reťazca znakov vynuluje šírku poľa, preto pred každým takým poľom znova použite std::setw. std::right nahrádza zarovnanie doľava zarovnaním doprava. Pri používaní zdieľaného prúdu pamätajte, že zmenený stav ovplyvňuje aj neskoršie výstupné operácie.
Príklad používa bodky, aby bolo vyplnenie viditeľné. Prvé dve polia ukazujú, že std::left zostáva aktívne, a posledné ukazuje prepnutie na std::right. Príklad môžete overiť lokálne s prepínačom -std=c++23. Zobrazený zdrojový kód bol spustený bez zmien v izolovanom prostredí a štandardný výstup (stdout) sa presne zhodoval s očakávaným výstupom. Toto overenie nepotvrdzuje správanie programu za behu v produkčnom prostredí.
Prí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ýsledok
|cat...|ox....| |...cat|
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
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]