KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::right — een uitvoerveld rechts uitlijnen

std::right stelt rechts uitlijnen in voor een uitvoerstroom: opvultekens komen vóór de waarde. Deze instelling blijft actief; de veldbreedte wordt afzonderlijk opgegeven, bijvoorbeeld met std::setw.

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

Syntax

#include <ios>
std::ios_base& std::right(std::ios_base& str);
// Usage: out << std::right << std::setw(width) << value;

std::right is een manipulator die in <ios> is gedeclareerd en wordt gebruikt als out << std::right. Hij roept str.setf(std::ios_base::right, std::ios_base::adjustfield) aan en retourneert een verwijzing naar dezelfde stroom. Hij vervangt de vorige instelling in de groep adjustfield, zoals std::left of std::internal, zonder andere vlaggroepen te wijzigen.

Als de veldbreedte groter is dan de lengte van de uitvoerrepresentatie, worden er opvultekens vóór geplaatst. std::right stelt zelf noch de breedte, noch het opvulteken in: gebruik daarvoor respectievelijk std::setw en std::setfill uit <iomanip>. De breedte is een minimum, geen limiet die tekst afkapt.

De uitlijning blijft ingesteld totdat de vlaggen opnieuw worden gewijzigd. Het invoegen van een teken of tekenreeks zet daarentegen de veldbreedte terug. Gebruik daarom opnieuw std::setw vóór elk veld van dit type dat opvulling nodig heeft. Verwar de blijvende uitlijningsinstelling niet met de breedte van één afzonderlijk veld.

Het voorbeeld stelt de punt in als opvulteken en schrijft twee tekenreeksen in velden met breedte 5. De scheidingstekens | geven de veldgrenzen aan; het verwachte resultaat is |..cat|...ox| gevolgd door een nieuwe regel.

Voorbeelden

#include <iomanip>
#include <ios>
#include <iostream>

int main() {
    std::cout << std::setfill('.') << std::right;
    std::cout << '|' << std::setw(5) << "cat"
              << '|' << std::setw(5) << "ox" << "|\n";
}

Resultaat

|..cat|...ox|

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