CKTIS / C++
std::setfill — znak za popunjavanje izlaznih polja
std::setfill iz <iomanip> postavlja znak kojim se popunjavaju polja tijekom formatiranog izlaza. Djeluje zajedno sa širinom polja, primjerice onom postavljenom pomoću std::setw, i ostaje aktivan dok se ne promijeni.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <iomanip>
// Declaration (unspecified denotes an unspecified return type):
template<class charT> unspecified setfill(charT c);
// Usage:
out << std::setfill(c);std::setfill(c) manipulator je iz <iomanip>. Izraz out << std::setfill(c) mijenja stanje toka kao da se poziva out.fill(c); sam ne ispisuje znakove. Funkcija vraća objekt neodređenog tipa, a cijeli izraz s << vraća referencu na out, pa se operacije mogu ulančavati.
Kada formatirani izlaz treba popunu do širine polja, tok koristi postavljeni znak. std::setw(n) određuje minimalnu širinu, a ne ograničenje duljine: dulji se tekst ne skraćuje. Za tekst std::right postavlja popunu ispred sadržaja, a std::left iza njega. Sam std::setfill ne postavlja ni širinu ni poravnanje.
Znak za popunjavanje ostaje postavljen za sljedeće operacije, dok umetanje znakova i nizova postavlja širinu polja na nulu. Zato ponovite std::setw prije svakog polja kojem je potrebna popuna. Ako se tok dijeli, spremite prethodni znak pomoću out.fill() i vratite ga pomoću out.fill(previous); time se ne vraćaju ostale postavke formatiranja.
Tip c mora odgovarati znakovnom tipu toka: upotrijebite, primjerice, '.' za tok char i L'.' za tok wchar_t. Primjer prikazuje da znak za popunjavanje ostaje postavljen te oba smjera poravnanja. Specifikacija za std::setfill nalazi se u odjeljku [std.manip] nacrta norme C++.
Primjeri
#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';
}
Rezultat
....A|...BC|D....
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.