CKTIS / C++
std::left — levo poravnaj izhodno polje
std::left izbere levo poravnavo oblikovanega izhoda toka. Če je polje širše od vrednosti, se polnilni znaki pojavijo za vrednostjo. Poravnava ostane aktivna, dokler je ne spremenimo.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <iomanip>
#include <ios>
#include <ostream>
// Usage with an output stream:
out << std::left << std::setw(width) << value;std::left je manipulator, deklariran v <ios>. Zapis out << std::left spremeni stanje oblikovanja toka, namesto da bi izpisal besedilo. Funkcija pokliče str.setf(std::ios_base::left, std::ios_base::adjustfield) in vrne str: zamenja nastavitev poravnave, ne da bi spremenila druge skupine zastavic.
V levo poravnanem izhodnem polju so polnilni znaki za vrednostjo. Širino nastavite z std::setw(width), polnilni znak pa z std::setfill(c); oba manipulatorja zahtevata <iomanip>. Širina je najmanjša: daljše besedilo ni odrezano. std::left sam ne nastavi niti širine niti polnilnega znaka.
Poravnava in polnilni znak ostaneta nastavljena, dokler ju ne spremenimo. V nasprotju s tem vstavljanje znaka ali znakovnega niza ponastavi širino polja, zato pred vsakim takim poljem znova uporabite std::setw. std::right levo poravnavo zamenja z desno. Pri uporabi skupnega toka upoštevajte, da spremenjeno stanje vpliva tudi na poznejše izhodne operacije.
Primer uporablja pike, da je polnjenje vidno. Prvi polji pokažeta, da std::left ostane aktiven, zadnje pa prikazuje preklop na std::right. Primer lahko lokalno preverite z možnostjo -std=c++23. Prikazana izvorna koda je bila v izoliranem okolju izvedena brez sprememb, standardni izhod (stdout) pa se je natančno ujemal s pričakovanim izhodom. To preverjanje ne potrjuje obnašanja programa med izvajanjem v produkcijskem okolju.
Primeri
#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";
}
Rezultat
|cat...|ox....| |...cat|
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- 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]