KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::setfill — vulteken voor uitvoervelden

std::setfill uit <iomanip> stelt het teken in waarmee velden bij geformatteerde uitvoer worden opgevuld. Het werkt samen met een veldbreedte, bijvoorbeeld ingesteld met std::setw, en blijft actief totdat het wordt gewijzigd.

Versie: 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) is een manipulator uit <iomanip>. De expressie out << std::setfill(c) wijzigt de toestand van de stream alsof out.fill(c) wordt aangeroepen; de expressie schrijft zelf geen tekens. De functie retourneert een object van een niet-gespecificeerd type, terwijl de volledige expressie met << een verwijzing naar out retourneert, zodat bewerkingen aan elkaar kunnen worden gekoppeld.

Wanneer geformatteerde uitvoer opvulling nodig heeft om de veldbreedte te bereiken, gebruikt de stream het ingestelde teken. std::setw(n) geeft een minimale breedte aan, geen lengtelimiet: langere tekst wordt niet afgekapt. Bij tekst plaatst std::right de opvulling vóór de inhoud en std::left erna. std::setfill stelt op zichzelf noch de breedte, noch de uitlijning in.

Het vulteken blijft ingesteld voor volgende bewerkingen, terwijl het invoegen van tekens en tekenreeksen de veldbreedte op nul zet. Herhaal daarom std::setw vóór elk veld dat opvulling nodig heeft. Als een stream wordt gedeeld, sla je het vorige teken op met out.fill() en herstel je het met out.fill(previous); andere opmaakinstellingen worden daarmee niet hersteld.

Het type van c moet overeenkomen met het tekentype van de stream: gebruik bijvoorbeeld '.' voor een char-stream en L'.' voor een wchar_t-stream. Het voorbeeld toont dat het vulteken ingesteld blijft en laat beide uitlijnrichtingen zien. De specificatie van std::setfill staat in paragraaf [std.manip] van de conceptversie van de C++-standaard.

Voorbeelden

#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';
}

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen