CKTIS / C++
std::setw — nastavenie šírky poľa streamu
std::setw(n), deklarované v <iomanip>, nastavuje šírku poľa streamu. Pri výstupe sa kratšie hodnoty doplnia a dlhšie sa neskracujú. Pre nasledujúce polia nastavte šírku znova, pretože výstupné operácie ju môžu vynulovať.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) je manipulátor deklarovaný v <iomanip>. Pri použití ako out << std::setw(n) alebo in >> std::setw(n) v danom streame fakticky volá width(n). Prijíma int a vracia objekt bližšie neurčeného typu, nie samotnú šírku. Pri vstupe závisí význam nastavenia od operácie extrakcie; nejde o všeobecný limit počtu číslic.
Pri výstupe určuje šírka minimálnu veľkosť poľa pre operácie, ktoré ju zohľadňujú. Kratšia reprezentácia dostane výplňové znaky; dlhšia sa vypíše celá. std::setfill vyberá výplňový znak, zatiaľ čo std::left a std::right umožňujú zarovnať text doľava, respektíve doprava.
Nepovažujte šírku za trvalé nastavenie stĺpca. Operácie vkladania znakov a reťazcov ju po použití vynulujú, preto vložte std::setw(n) bezprostredne pred každé pole, ktoré potrebuje doplnenie. Šírku môže spotrebovať aj oddeľovač vložený pred zamýšľanú hodnotu. Samotné nastavenie výplne alebo zarovnania ju nespotrebuje; tieto nastavenia zostávajú aktívne, kým ich nezmeníte.
V príklade dostane cat naľavo dve bodky, x sa nedopĺňa a dog dostane dve bodky napravo. bird zostane celý aj pri šírke 2. std::setw je definované v časti [std.manip]. Citovaný dokument je pracovný návrh, nie konečné vydanie C++23.
Príklady
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
out << std::setfill('.') << std::right;
out << '|' << std::setw(5) << "cat" << '|' << "x" << '|';
out << std::left << std::setw(5) << "dog" << '|';
out << std::setw(2) << "bird" << '|';
std::cout << out.str() << '\n';
}
Výsledok
|..cat|x|dog..|bird|
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.