Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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