Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::setw — nastavenie šírky poľa streamu

std::setw(n), deklarované v <iomanip>, nastavuje šírku poľa streamu. Pri výstupe sa kratšie hodnoty doplnia a dlhšie sa neskracujú. Pre nasledujúce polia nastavte šírku znova, pretože výstupné operácie ju môžu vynulovať.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;

std::setw(n) je manipulátor deklarovaný v <iomanip>. Pri použití ako out << std::setw(n) alebo in >> std::setw(n) v danom streame fakticky volá width(n). Prijíma int a vracia objekt bližšie neurčeného typu, nie samotnú šírku. Pri vstupe závisí význam nastavenia od operácie extrakcie; nejde o všeobecný limit počtu číslic.

Pri výstupe určuje šírka minimálnu veľkosť poľa pre operácie, ktoré ju zohľadňujú. Kratšia reprezentácia dostane výplňové znaky; dlhšia sa vypíše celá. std::setfill vyberá výplňový znak, zatiaľ čo std::left a std::right umožňujú zarovnať text doľava, respektíve doprava.

Nepovažujte šírku za trvalé nastavenie stĺpca. Operácie vkladania znakov a reťazcov ju po použití vynulujú, preto vložte std::setw(n) bezprostredne pred každé pole, ktoré potrebuje doplnenie. Šírku môže spotrebovať aj oddeľovač vložený pred zamýšľanú hodnotu. Samotné nastavenie výplne alebo zarovnania ju nespotrebuje; tieto nastavenia zostávajú aktívne, kým ich nezmeníte.

V príklade dostane cat naľavo dve bodky, x sa nedopĺňa a dog dostane dve bodky napravo. bird zostane celý aj pri šírke 2. std::setw je definované v časti [std.manip]. Citovaný dokument je pracovný návrh, nie konečné vydanie C++23.

Príklady

#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';
}

Výsledok

|..cat|x|dog..|bird|

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje