Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::setfill — výplňový znak výstupních polí

std::setfill z <iomanip> nastavuje znak používaný k vyplňování polí při formátovaném výstupu. Funguje společně s šířkou pole, například nastavenou pomocí std::setw, a zůstává aktivní, dokud se nezmění.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#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) změní stav proudu stejně jako volání out.fill(c); sám žádné znaky nevypisuje. Funkce vrací objekt blíže neurčeného typu, zatímco celý výraz s << vrací referenci na out, takže lze operace řetězit.

Když formátovaný výstup potřebuje doplnění na šířku pole, proud použije nastavený znak. std::setw(n) určuje minimální šířku, nikoli délkový limit: delší text se nezkracuje. U textu umístí std::right výplň před obsah a std::left za něj. Samotné std::setfill nenastavuje šířku ani zarovnání.

Výplňový znak zůstává nastavený pro další operace, zatímco vkládání znaků a řetězců nastaví šířku pole na nulu. Proto před každým polem, které potřebuje doplnit, znovu použijte std::setw. Pokud proud sdílíte, uložte předchozí znak pomocí out.fill() a obnovte jej pomocí out.fill(previous); ostatní nastavení formátování se tím neobnoví.

Typ c musí odpovídat znakovému typu proudu: použijte například '.' pro proud char a L'.' pro proud wchar_t. Příklad ukazuje, že výplňový znak zůstává nastavený, a obě možnosti zarovnání. Specifikace std::setfill je v oddílu [std.manip] návrhu normy C++.

Pří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ýsledek

....A|...BC|D....

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje