Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri