CKTIS / C++
std::setw — nastavitev širine polja toka
std::setw(n), deklariran v <iomanip>, nastavi širino polja toka. Pri izhodu se krajše vrednosti dopolnijo, daljše pa se ne skrajšajo. Za vsako naslednje polje širino nastavite znova, saj jo lahko izhodne operacije ponastavijo.
Različica: 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) je manipulator, deklariran v <iomanip>. Če ga uporabite kot out << std::setw(n) ali in >> std::setw(n), na ustreznem toku dejansko pokliče width(n). Sprejme int in vrne objekt nedoločenega tipa, ne pa širine same. Pri vhodu je pomen nastavitve odvisen od operacije ekstrakcije; ne gre za splošno omejitev števila števk.
Pri izhodu širina določa najmanjšo velikost polja za operacije, ki jo upoštevajo. Krajši zapis dobi polnilne znake, daljši pa se izpiše v celoti. std::setfill izbere polnilni znak, std::left in std::right pa omogočata poravnavo besedila levo oziroma desno.
Širine ne obravnavajte kot trajne nastavitve stolpca. Operacije vstavljanja znakov in znakovnih nizov jo po uporabi ponastavijo, zato postavite std::setw(n) neposredno pred vsako polje, ki potrebuje dopolnitev. Širino lahko porabi tudi ločilo, vstavljeno pred predvideno vrednost. Zgolj nastavitev polnila ali poravnave je ne porabi; ti nastavitvi ostaneta aktivni, dokler ju ne spremenite.
V primeru cat dobi dve piki na levi, x ni dopolnjen, dog pa dobi dve piki na desni. bird ostane v celoti izpisan kljub širini 2. std::setw je opredeljen v razdelku [std.manip]. Navedeni dokument je delovni osnutek, ne dokončna objava C++23.
Primeri
#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|
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.