CKTIS / C++
std::right — zarovnání výstupního pole doprava
std::right nastaví ve výstupním proudu zarovnání doprava: výplňové znaky se umístí před hodnotu. Nastavení zůstává aktivní, zatímco šířka pole se zadává zvlášť, například pomocí std::setw.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ios>
std::ios_base& std::right(std::ios_base& str);
// Usage: out << std::right << std::setw(width) << value;std::right je manipulátor deklarovaný v <ios>, který se používá jako out << std::right. Volá str.setf(std::ios_base::right, std::ios_base::adjustfield) a vrací odkaz na tentýž proud. Nahrazuje předchozí nastavení skupiny adjustfield, například std::left nebo std::internal, aniž by měnil ostatní skupiny příznaků.
Pokud je šířka pole větší než délka výstupní reprezentace, výplňové znaky se přidají před ni. Samotný std::right nenastavuje ani šířku, ani výplňový znak: k tomu slouží std::setw a std::setfill z <iomanip>. Šířka je minimum, nikoli limit, který text zkrátí.
Zarovnání zůstává nastavené, dokud se příznaky znovu nezmění. Vložení znaku nebo řetězce znaků naproti tomu šířku pole vynuluje, takže před každým takovým polem, které potřebuje doplnit, znovu použijte std::setw. Nezaměňujte trvalé nastavení zarovnání za šířku jednotlivého pole.
Příklad nastaví tečku jako výplňový znak a vypíše dva řetězce do polí o šířce 5. Oddělovače | ukazují hranice polí; očekávaný výsledek je |..cat|...ox| následovaný znakem nového řádku.
Příklady
#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";
}
Výsledek
|..cat|...ox|
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
- 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]