Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::setw — nastavení šířky pole streamu

std::setw(n), deklarované v <iomanip>, nastavuje šířku pole streamu. Při výstupu se kratší hodnoty doplní a delší se nezkracují. Pro následující pole nastavte šířku znovu, protože výstupní operace ji mohou vynulovat.

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

Syntaxe

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

std::setw(n) je manipulátor deklarovaný v <iomanip>. Při použití jako out << std::setw(n) nebo in >> std::setw(n) v daném streamu fakticky volá width(n). Přijímá int a vrací objekt blíže neurčeného typu, nikoli samotnou šířku. Při vstupu závisí význam nastavení na operaci extrakce; nejde o obecný limit počtu číslic.

Při výstupu určuje šířka minimální velikost pole pro operace, které ji zohledňují. Kratší reprezentace dostane výplňové znaky; delší se vypíše celá. std::setfill vybírá výplňový znak, zatímco std::left a std::right umožňují zarovnat text doleva, respektive doprava.

Nepovažujte šířku za trvalé nastavení sloupce. Operace vkládání znaků a řetězců ji po použití vynulují, proto vložte std::setw(n) bezprostředně před každé pole, které potřebuje doplnění. Šířku může spotřebovat i oddělovač vložený před zamýšlenou hodnotu. Samotné nastavení výplně nebo zarovnání ji nespotřebuje; tato nastavení zůstávají aktivní, dokud je nezměníte.

V příkladu dostane cat vlevo dvě tečky, x se nedoplňuje a dog dostane dvě tečky vpravo. bird zůstane celý i při šířce 2. std::setw je definováno v oddílu [std.manip]. Citovaný dokument je pracovní návrh, nikoli konečné vydání C++23.

Pří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ýsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje