Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła