CKTIS / C++
std::left — een uitvoerveld links uitlijnen
std::left kiest voor links uitlijnen bij geformatteerde streamuitvoer. Als een veld breder is dan de waarde, verschijnen de opvultekens na de waarde. De uitlijning blijft actief totdat deze wordt gewijzigd.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <iomanip>
#include <ios>
#include <ostream>
// Usage with an output stream:
out << std::left << std::setw(width) << value;std::left is een manipulator die in <ios> is gedeclareerd. out << std::left wijzigt de opmaakstatus van de stream in plaats van tekst af te drukken. De functie roept str.setf(std::ios_base::left, std::ios_base::adjustfield) aan en retourneert str: de uitlijningsinstelling wordt vervangen zonder andere vlaggroepen te wijzigen.
In een links uitgelijnd uitvoerveld volgen de opvultekens op de waarde. Stel de breedte in met std::setw(width) en het opvulteken met std::setfill(c); beide manipulators vereisen <iomanip>. De breedte is een minimum: langere tekst wordt niet afgekapt. std::left stelt zelf noch de breedte, noch het opvulteken in.
De uitlijning en het opvulteken blijven ingesteld totdat ze worden gewijzigd. Daarentegen wordt de veldbreedte gereset wanneer een teken of tekenreeks wordt ingevoegd; gebruik daarom vóór elk veld van dit type opnieuw std::setw. std::right vervangt de linkse uitlijning door rechtse uitlijning. Houd er bij een gedeelde stream rekening mee dat de gewijzigde status ook latere uitvoerbewerkingen beïnvloedt.
Het voorbeeld gebruikt punten om de opvulling zichtbaar te maken. De eerste twee velden laten zien dat std::left actief blijft; het laatste toont de omschakeling naar std::right. Je kunt het voorbeeld lokaal verifiëren met -std=c++23. De getoonde broncode is ongewijzigd uitgevoerd in een geïsoleerde omgeving en de standaarduitvoer (stdout) kwam exact overeen met de verwachte uitvoer. Deze verificatie bevestigt geen runtimegedrag in productie.
Voorbeelden
#include <iomanip>
#include <ios>
#include <iostream>
int main() {
std::cout << std::setfill('.') << std::left;
std::cout << '|' << std::setw(6) << "cat"
<< '|' << std::setw(6) << "ox" << "|\n";
std::cout << std::right
<< '|' << std::setw(6) << "cat" << "|\n";
}
Resultaat
|cat...|ox....| |...cat|
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
- C++ working draft — adjustfield manipulators [adjustfield.manip]
- C++ working draft — Header <ios> synopsis [ios.syn]
- C++ working draft — Common requirements [ostream.formatted.reqmts]
- C++ working draft — Character inserter function templates [ostream.inserters.character]
- C++ working draft — Standard manipulators [std.manip]