Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje