CKTIS / C++
std::left — alinhar um campo de saída à esquerda
std::left seleciona o alinhamento à esquerda para a saída formatada de um fluxo. Quando um campo é mais largo do que o respetivo valor, os caracteres de preenchimento aparecem depois do valor. O alinhamento mantém-se ativo até ser alterado.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <iomanip>
#include <ios>
#include <ostream>
// Usage with an output stream:
out << std::left << std::setw(width) << value;std::left é um manipulador declarado em <ios>. Escrever out << std::left altera o estado de formatação do fluxo, em vez de imprimir texto. A função chama str.setf(std::ios_base::left, std::ios_base::adjustfield) e devolve str: substitui a definição do alinhamento sem alterar outros grupos de flags.
Num campo de saída alinhado à esquerda, os caracteres de preenchimento surgem depois do valor. Defina a largura com std::setw(width) e o carácter de preenchimento com std::setfill(c); ambos os manipuladores requerem <iomanip>. A largura é um mínimo: o texto mais longo não é truncado. std::left não define, por si só, a largura nem o carácter de preenchimento.
O alinhamento e o carácter de preenchimento mantêm-se definidos até serem alterados. Em contrapartida, inserir um carácter ou uma cadeia de caracteres repõe a largura do campo; por isso, volte a usar std::setw antes de cada campo desse tipo. std::right substitui o alinhamento à esquerda pelo alinhamento à direita. Ao usar um fluxo partilhado, tenha em conta que o estado alterado também afeta operações de saída posteriores.
O exemplo usa pontos para tornar visível o preenchimento. Os dois primeiros campos mostram que std::left se mantém ativo, e o último demonstra a mudança para std::right. Pode verificar o exemplo localmente com -std=c++23. O código-fonte apresentado foi executado sem alterações num ambiente isolado e a saída padrão (stdout) coincidiu exatamente com a saída esperada. Esta verificação não atesta o comportamento em tempo de execução em produção.
Exemplos
#include <iomanip>
#include <ios>
#include <iostream>
int main() {
std::cout << std::setfill('.') << std::left;
std::cout << '|' << std::setw(6) << "cat"
<< '|' << std::setw(6) << "ox" << "|\n";
std::cout << std::right
<< '|' << std::setw(6) << "cat" << "|\n";
}
Resultado
|cat...|ox....| |...cat|
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]