CKTIS / C++
std::setfill — знак за запълване на изходни полета
std::setfill от <iomanip> задава знака, използван за запълване на полета при форматиран изход. Работи заедно с ширина на поле, например зададена чрез std::setw, и остава активен, докато не бъде променен.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <iomanip>
// Declaration (unspecified denotes an unspecified return type):
template<class charT> unspecified setfill(charT c);
// Usage:
out << std::setfill(c);std::setfill(c) е манипулатор от <iomanip>. Изразът out << std::setfill(c) променя състоянието на потока така, сякаш се извиква out.fill(c); самият той не извежда знаци. Функцията връща обект с неуточнен тип, а целият израз с << връща препратка към out, което позволява операциите да се свързват последователно.
Когато форматираният изход трябва да се допълни до ширината на поле, потокът използва зададения знак. std::setw(n) определя минимална ширина, а не ограничение за дължината: по-дългият текст не се съкращава. За текст std::right поставя запълването преди съдържанието, а std::left — след него. Самостоятелно std::setfill не задава нито ширина, нито подравняване.
Знакът за запълване остава зададен за следващите операции, докато вмъкването на знаци и низове нулира ширината на полето. Затова повтаряйте std::setw преди всяко поле, което трябва да се запълни. Когато потокът се споделя, запазете предишния знак чрез out.fill() и го възстановете чрез out.fill(previous); това не възстановява другите настройки за форматиране.
Типът на c трябва да съответства на типа на знаците в потока: използвайте например '.' за поток char и L'.' за поток wchar_t. Примерът показва, че знакът за запълване остава активен, както и двете посоки на подравняване. Спецификацията на std::setfill е в раздел [std.manip] на проекта на стандарта за C++.
Примери
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
const char previous = out.fill();
out << std::setfill('.') << std::right
<< std::setw(5) << "A" << '|'
<< std::setw(5) << "BC" << '|'
<< std::left << std::setw(5) << "D";
out.fill(previous);
std::cout << out.str() << '\n';
}
Резултат
....A|...BC|D....
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.