CKTIS / C++
std::setw — de veldbreedte van een stream instellen
std::setw(n), gedeclareerd in <iomanip>, stelt de veldbreedte van een stream in. Bij uitvoer worden kortere waarden opgevuld en langere waarden niet afgekapt. Stel de breedte opnieuw in voor opeenvolgende velden, omdat uitvoerbewerkingen deze kunnen resetten.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) is een manipulator die in <iomanip> is gedeclareerd. Gebruikt als out << std::setw(n) of in >> std::setw(n), roept deze effectief width(n) aan op de betreffende stream. De functie accepteert een int en geeft een object van een niet nader gespecificeerd type terug, niet de breedte zelf. Bij invoer hangt de betekenis van de instelling af van de extractiebewerking; het is geen algemene beperking van het aantal cijfers.
Bij uitvoer geeft de breedte de minimale veldgrootte aan voor bewerkingen die ermee rekening houden. Een kortere weergave krijgt opvultekens; een langere wordt volledig geschreven. std::setfill kiest het opvulteken, terwijl std::left en std::right tekst respectievelijk links en rechts uitlijnen.
Beschouw de breedte niet als een blijvende kolominstelling. Invoegbewerkingen voor tekens en tekenreeksen resetten deze na gebruik. Plaats daarom std::setw(n) direct vóór elk veld dat opvulling nodig heeft. Ook een scheidingsteken dat vóór de bedoelde waarde wordt ingevoegd, kan de breedte verbruiken. Alleen de opvulling of uitlijning instellen verbruikt de breedte niet; die instellingen blijven actief totdat ze worden gewijzigd.
In het voorbeeld krijgt cat links twee punten, wordt x niet opgevuld en krijgt dog rechts twee punten. bird blijft volledig ondanks breedte 2. std::setw is gedefinieerd in de sectie [std.manip]. Het aangehaalde document is een werkconcept, geen definitieve C++23-publicatie.
Voorbeelden
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
out << std::setfill('.') << std::right;
out << '|' << std::setw(5) << "cat" << '|' << "x" << '|';
out << std::left << std::setw(5) << "dog" << '|';
out << std::setw(2) << "bird" << '|';
std::cout << out.str() << '\n';
}
Resultaat
|..cat|x|dog..|bird|
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.