База знанияИзпитен център
BGБългарски
Избери език13

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|

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници