CKTIS / C++
std::setw — задаване на ширината на поле в поток
std::setw(n), деклариран в <iomanip>, задава ширината на поле в поток. При извеждане по-късите стойности се допълват, а по-дългите не се отрязват. Задавайте ширината отново за всяко следващо поле, защото операциите за извеждане могат да я нулират.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) е манипулатор, деклариран в <iomanip>. Използван като out << std::setw(n) или in >> std::setw(n), той на практика извиква width(n) за съответния поток. Приема int и връща обект от неуточнен тип, а не самата ширина. При вход значението на настройката зависи от операцията за извличане; това не е общо ограничение за броя на цифрите.
При изход ширината задава минималния размер на полето за операциите, които я вземат предвид. По-късо представяне получава запълващи знаци, а по-дълго се извежда изцяло. std::setfill избира запълващия знак, а std::left и std::right позволяват подравняване на текста съответно наляво и надясно.
Не приемайте ширината за постоянно зададена ширина на колона. Операциите за вмъкване на знаци и низове я нулират след употреба, затова поставяйте std::setw(n) непосредствено преди всяко поле, което трябва да се запълни. Дори разделител, вмъкнат преди предвидената стойност, може да изразходва ширината. Самото задаване на запълване или подравняване не я изразходва; тези настройки остават активни, докато не бъдат променени.
В примера cat получава две точки отляво, x не се запълва, а dog получава две точки отдясно. bird остава цял въпреки ширината 2. std::setw е дефиниран в раздел [std.manip]. Цитираният документ е работен проект, а не окончателна публикация на C++23.
Примери
#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';
}
Резултат
|..cat|x|dog..|bird|
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.