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

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....

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

Източници