CKTIS / C++
std::setw — definir a largura do campo de um fluxo
std::setw(n), declarado em <iomanip>, define a largura do campo de um fluxo. Na saída, os valores mais curtos são preenchidos e os mais longos não são truncados. Volte a aplicar a largura a cada campo seguinte, pois as operações de saída podem repô-la.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;std::setw(n) é um manipulador declarado em <iomanip>. Quando usado como out << std::setw(n) ou in >> std::setw(n), chama, na prática, width(n) no fluxo em causa. Aceita um int e devolve um objeto de tipo não especificado, não a própria largura. Na entrada, o significado da definição depende da operação de extração; não se trata de um limite geral ao número de algarismos.
Na saída, a largura indica o tamanho mínimo do campo para as operações que a têm em conta. Uma representação mais curta recebe caracteres de preenchimento; uma mais longa é escrita por inteiro. std::setfill escolhe o carácter de preenchimento, enquanto std::left e std::right permitem alinhar o texto à esquerda e à direita, respetivamente.
Não trate a largura como uma definição permanente da coluna. As operações de inserção de caracteres e cadeias de caracteres repõem-na após a utilização; por isso, coloque std::setw(n) imediatamente antes de cada campo que precise de preenchimento. Até um separador inserido antes do valor pretendido pode consumir a largura. Definir apenas o preenchimento ou o alinhamento não a consome; estas definições mantêm-se ativas até serem alteradas.
No exemplo, cat recebe dois pontos à esquerda, x não é preenchido e dog recebe dois pontos à direita. bird permanece completo apesar da largura 2. std::setw está definido na secção [std.manip]. O documento citado é um projeto de trabalho, não uma publicação definitiva de C++23.
Exemplos
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
out << std::setfill('.') << std::right;
out << '|' << std::setw(5) << "cat" << '|' << "x" << '|';
out << std::left << std::setw(5) << "dog" << '|';
out << std::setw(2) << "bird" << '|';
std::cout << out.str() << '\n';
}
Resultado
|..cat|x|dog..|bird|
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.