CKTIS / C++
std::setfill — výplňový znak výstupných polí
std::setfill z <iomanip> nastavuje znak používaný na vypĺňanie polí pri formátovanom výstupe. Funguje spolu so šírkou poľa, napríklad nastavenou pomocou std::setw, a zostáva aktívny, kým sa nezmení.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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 manipulátor z <iomanip>. Výraz out << std::setfill(c) zmení stav prúdu tak, ako keby sa zavolalo out.fill(c); sám nevypisuje znaky. Funkcia vracia objekt bližšie neurčeného typu, zatiaľ čo celý výraz s << vracia referenciu na out, takže operácie možno reťaziť.
Keď formátovaný výstup potrebuje doplnenie na šírku poľa, prúd použije nastavený znak. std::setw(n) určuje minimálnu šírku, nie limit dĺžky: dlhší text sa neskracuje. Pri texte umiestni std::right výplň pred obsah a std::left zaň. Samotné std::setfill nenastavuje šírku ani zarovnanie.
Výplňový znak zostáva nastavený pre ďalšie operácie, zatiaľ čo vkladanie znakov a reťazcov nastaví šírku poľa na nulu. Preto pred každým poľom, ktoré treba doplniť, znova použite std::setw. Ak prúd zdieľate, uložte predchádzajúci znak pomocou out.fill() a obnovte ho pomocou out.fill(previous); ostatné nastavenia formátovania sa tým neobnovia.
Typ c musí zodpovedať znakovému typu prúdu: použite napríklad '.' pre prúd char a L'.' pre prúd wchar_t. Príklad ukazuje pretrvávanie výplňového znaku aj oba smery zarovnania. Špecifikácia std::setfill je v časti [std.manip] návrhu normy C++.
Príklady
#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';
}
Výsledok
....A|...BC|D....
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.