CKTIS / C++
std::setfill — znak wypełnienia pola wyjściowego
std::setfill z nagłówka <iomanip> ustawia znak używany do wypełniania pól podczas formatowanego wyjścia. Działa razem z szerokością pola, np. ustawioną przez std::setw, a jego ustawienie pozostaje aktywne do kolejnej zmiany.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <iomanip>
// Declaration (unspecified denotes an unspecified return type):
template<class charT> unspecified setfill(charT c);
// Usage:
out << std::setfill(c);std::setfill(c) to manipulator z nagłówka <iomanip>. Wyrażenie out << std::setfill(c) zmienia stan strumienia tak, jak wywołanie out.fill(c); samo nie wypisuje znaków. Funkcja zwraca obiekt nieokreślonego typu, a całe wyrażenie z << zwraca referencję do out, więc można łączyć operacje.
Gdy formatowane wyjście wymaga dopełnienia do szerokości pola, strumień używa ustawionego znaku. std::setw(n) określa minimalną szerokość, a nie limit długości: dłuższy tekst nie jest obcinany. Dla tekstu std::right umieszcza wypełnienie przed treścią, a std::left po niej. Samo std::setfill nie ustawia szerokości ani wyrównania.
Znak wypełnienia pozostaje ustawiony dla kolejnych operacji, natomiast wstawianie znaków i łańcuchów zeruje szerokość pola. Dlatego powtarzaj std::setw przed każdym polem wymagającym dopełnienia. Przy współdzieleniu strumienia zapisz poprzedni znak przez out.fill() i przywróć go przez out.fill(previous); nie przywraca to innych ustawień formatowania.
Typ c musi odpowiadać typowi znaków strumienia: użyj np. '.' dla strumienia char, a L'.' dla strumienia wchar_t. Przykład pokazuje trwałość znaku wypełnienia oraz oba kierunki wyrównania. Specyfikacja std::setfill znajduje się w sekcji [std.manip] projektu standardu C++.
Przykłady
#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';
}
Wynik
....A|...BC|D....
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.