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
- C++ working draft — adjustfield manipulators [adjustfield.manip]
- C++ working draft — Header <ios> synopsis [ios.syn]
- C++ working draft — Common requirements [ostream.formatted.reqmts]
- C++ working draft — Character inserter function templates [ostream.inserters.character]
- C++ working draft — Standard manipulators [std.manip]