CKTIS / C++
std::setw — ustawianie szerokości pola strumienia
std::setw(n) z nagłówka <iomanip> ustawia szerokość pola strumienia. Na wyjściu krótsze wartości są dopełniane, a dłuższe nie są obcinane. Szerokość trzeba ponawiać dla kolejnych pól, ponieważ operacje wypisywania mogą ją zerować.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) to manipulator z nagłówka <iomanip>. Użyty jako out << std::setw(n) lub in >> std::setw(n) wywołuje w efekcie width(n) dla danego strumienia. Przyjmuje int i zwraca obiekt nieokreślonego typu, a nie samą szerokość. Znaczenie ustawienia na wejściu zależy od operacji odczytu; nie jest to ogólny limit liczby cyfr.
Na wyjściu szerokość określa minimalny rozmiar pola dla operacji, które ją uwzględniają. Krótsza reprezentacja otrzymuje znaki wypełnienia; dłuższa jest wypisywana w całości. std::setfill wybiera znak wypełnienia, a std::left i std::right pozwalają wyrównywać tekst odpowiednio do lewej i prawej strony.
Nie traktuj szerokości jako trwałego ustawienia kolumny. Operacje wypisywania znaków i łańcuchów znakowych zerują ją po użyciu, więc umieszczaj std::setw(n) bezpośrednio przed każdym polem wymagającym dopełnienia. Nawet separator wypisany przed właściwą wartością może zużyć szerokość. Samo ustawienie wypełnienia lub wyrównania jej nie zużywa; te ustawienia pozostają aktywne do zmiany.
W przykładzie cat otrzymuje dwie kropki z lewej, x nie jest dopełniane, a dog otrzymuje dwie kropki z prawej. bird pozostaje w całości mimo szerokości 2. Definicja std::setw znajduje się w sekcji [std.manip]. Cytowany dokument jest roboczym projektem standardu, nie zamrożoną publikacją C++23.
Przykłady
#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';
}
Wynik
|..cat|x|dog..|bird|
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.