CKTIS / C++
std::setw — postavljanje širine polja toka
std::setw(n), deklariran u <iomanip>, postavlja širinu polja toka. Pri izlazu se kraće vrijednosti dopunjuju, a dulje se ne skraćuju. Ponovno postavite širinu za svako sljedeće polje jer je izlazne operacije mogu poništiti.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) manipulator je deklariran u <iomanip>. Upotrijebljen kao out << std::setw(n) ili in >> std::setw(n), za odgovarajući tok zapravo poziva width(n). Prima int i vraća objekt neodređenog tipa, a ne samu širinu. Pri unosu značenje postavke ovisi o operaciji izdvajanja; to nije opće ograničenje broja znamenki.
Pri izlazu širina određuje minimalnu veličinu polja za operacije koje je uzimaju u obzir. Kraći prikaz dobiva znakove za popunjavanje, a dulji se ispisuje u cijelosti. std::setfill odabire znak za popunjavanje, dok std::left i std::right omogućuju poravnavanje teksta ulijevo, odnosno udesno.
Nemojte širinu smatrati trajnom postavkom stupca. Operacije umetanja znakova i nizova znakova poništavaju je nakon uporabe, zato postavite std::setw(n) neposredno prije svakog polja koje treba popuniti. Širinu može potrošiti i razdjelnik umetnut prije predviđene vrijednosti. Samo postavljanje popunjavanja ili poravnanja ne troši širinu; te postavke ostaju aktivne dok ih ne promijenite.
U primjeru cat dobiva dvije točke slijeva, x se ne popunjava, a dog dobiva dvije točke zdesna. bird ostaje cijeli unatoč širini 2. std::setw definiran je u odjeljku [std.manip]. Navedeni dokument radni je nacrt, a ne konačna publikacija C++23.
Primjeri
#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';
}
Rezultat
|..cat|x|dog..|bird|
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.