CKTIS / C++
std::setfill — polnilni znak izhodnih polj
std::setfill iz <iomanip> nastavi znak, ki se uporablja za polnjenje polj pri oblikovanem izpisu. Deluje skupaj s širino polja, na primer nastavljeno s std::setw, in ostane aktiven, dokler ga ne spremenimo.
Različica: 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) je manipulator iz <iomanip>. Izraz out << std::setfill(c) spremeni stanje toka, kot da bi poklicali out.fill(c); sam ne izpiše znakov. Funkcija vrne objekt nedoločenega tipa, celoten izraz z << pa vrne sklic na out, zato lahko operacije verižiš.
Ko je treba oblikovani izpis dopolniti do širine polja, tok uporabi nastavljeni znak. std::setw(n) določa najmanjšo širino, ne omejitve dolžine: daljše besedilo se ne odreže. Pri besedilu std::right postavi polnilo pred vsebino, std::left pa za njo. std::setfill sam ne nastavi niti širine niti poravnave.
Polnilni znak ostane nastavljen za naslednje operacije, vstavljanje znakov in nizov pa širino polja ponastavi na nič. Zato pred vsakim poljem, ki potrebuje polnilo, znova uporabi std::setw. Če tok deliš, shrani prejšnji znak z out.fill() in ga obnovi z out.fill(previous); druge nastavitve oblikovanja se s tem ne obnovijo.
Tip c se mora ujemati z znakovnim tipom toka: uporabi na primer '.' za tok char in L'.' za tok wchar_t. Primer prikazuje, da polnilni znak ostane nastavljen, ter obe smeri poravnave. Specifikacija za std::setfill je v razdelku [std.manip] osnutka standarda C++.
Primeri
#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....
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.