Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::right — wyrównanie pola wyjściowego do prawej

std::right ustawia wyrównanie do prawej w strumieniu wyjściowym: znaki wypełnienia trafiają przed wartość. Ustawienie pozostaje aktywne, a szerokość pola określa się osobno, na przykład przez std::setw.

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

Składnia

#include <ios>
std::ios_base& std::right(std::ios_base& str);
// Usage: out << std::right << std::setw(width) << value;

std::right to manipulator zadeklarowany w <ios>, używany jako out << std::right. Wywołuje str.setf(std::ios_base::right, std::ios_base::adjustfield) i zwraca referencję do tego samego strumienia. Zastępuje poprzednie ustawienie grupy adjustfield, na przykład std::left lub std::internal, bez zmiany pozostałych grup flag.

Jeśli szerokość pola jest większa od długości wypisywanej reprezentacji, znaki wypełnienia są dodawane przed nią. Samo std::right nie ustala szerokości ani znaku wypełnienia: służą do tego odpowiednio std::setw i std::setfill z <iomanip>. Szerokość jest minimum, nie limitem obcinającym tekst.

Wyrównanie pozostaje ustawione do kolejnej zmiany flag. Natomiast wstawienie znaku lub napisu zeruje szerokość pola, dlatego przed każdym takim polem wymagającym dopełnienia trzeba ponownie użyć std::setw. Nie myl trwałego ustawienia wyrównania z szerokością pojedynczego pola.

Przykład ustawia kropkę jako znak wypełnienia i wypisuje dwa napisy w polach o szerokości 5. Separatory | pokazują granice pól; oczekiwany wynik to |..cat|...ox| zakończony znakiem nowej linii.

Przykłady

#include <iomanip>
#include <ios>
#include <iostream>

int main() {
    std::cout << std::setfill('.') << std::right;
    std::cout << '|' << std::setw(5) << "cat"
              << '|' << std::setw(5) << "ox" << "|\n";
}

Wynik

|..cat|...ox|

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła