CKTIS / C++
std::setw — nastavení šířky pole streamu
std::setw(n), deklarované v <iomanip>, nastavuje šířku pole streamu. Při výstupu se kratší hodnoty doplní a delší se nezkracují. Pro následující pole nastavte šířku znovu, protože výstupní operace ji mohou vynulovat.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) je manipulátor deklarovaný v <iomanip>. Při použití jako out << std::setw(n) nebo in >> std::setw(n) v daném streamu fakticky volá width(n). Přijímá int a vrací objekt blíže neurčeného typu, nikoli samotnou šířku. Při vstupu závisí význam nastavení na operaci extrakce; nejde o obecný limit počtu číslic.
Při výstupu určuje šířka minimální velikost pole pro operace, které ji zohledňují. Kratší reprezentace dostane výplňové znaky; delší se vypíše celá. std::setfill vybírá výplňový znak, zatímco std::left a std::right umožňují zarovnat text doleva, respektive doprava.
Nepovažujte šířku za trvalé nastavení sloupce. Operace vkládání znaků a řetězců ji po použití vynulují, proto vložte std::setw(n) bezprostředně před každé pole, které potřebuje doplnění. Šířku může spotřebovat i oddělovač vložený před zamýšlenou hodnotu. Samotné nastavení výplně nebo zarovnání ji nespotřebuje; tato nastavení zůstávají aktivní, dokud je nezměníte.
V příkladu dostane cat vlevo dvě tečky, x se nedoplňuje a dog dostane dvě tečky vpravo. bird zůstane celý i při šířce 2. std::setw je definováno v oddílu [std.manip]. Citovaný dokument je pracovní návrh, nikoli konečné vydání C++23.
Pří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ýsledek
|..cat|x|dog..|bird|
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.