CKTIS / C++
std::right — alinhar um campo de saída à direita
std::right define o alinhamento à direita num fluxo de saída: os caracteres de preenchimento surgem antes do valor. A definição mantém-se ativa, enquanto a largura do campo é especificada separadamente, por exemplo com std::setw.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <ios>
std::ios_base& std::right(std::ios_base& str);
// Usage: out << std::right << std::setw(width) << value;std::right é um manipulador declarado em <ios>, usado como out << std::right. Chama str.setf(std::ios_base::right, std::ios_base::adjustfield) e devolve uma referência ao mesmo fluxo. Substitui a definição anterior do grupo adjustfield, como std::left ou std::internal, sem alterar os outros grupos de sinalizadores.
Se a largura do campo for superior ao comprimento da representação de saída, são acrescentados caracteres de preenchimento antes desta. std::right não define, por si só, nem a largura nem o carácter de preenchimento: para isso, use std::setw e std::setfill de <iomanip>, respetivamente. A largura é um mínimo, não um limite que trunque o texto.
O alinhamento mantém-se ativo até os sinalizadores serem alterados. Em contrapartida, a inserção de um carácter ou de uma cadeia de caracteres repõe a largura do campo; por isso, volte a usar std::setw antes de cada campo deste tipo que precise de preenchimento. Não confunda a definição persistente do alinhamento com a largura de um campo individual.
O exemplo define o ponto como carácter de preenchimento e escreve duas cadeias em campos de largura 5. Os separadores | mostram os limites dos campos; o resultado esperado é |..cat|...ox| seguido de uma mudança de linha.
Exemplos
#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";
}
Resultado
|..cat|...ox|
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.
Fontes
- 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]