Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori