CKTIS / C++
std::setfill — carácter de preenchimento dos campos de saída
std::setfill de <iomanip> define o carácter usado para preencher campos durante a saída formatada. Funciona em conjunto com uma largura de campo, por exemplo, definida por std::setw, e mantém-se ativo até ser alterado.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <iomanip>
// Declaration (unspecified denotes an unspecified return type):
template<class charT> unspecified setfill(charT c);
// Usage:
out << std::setfill(c);std::setfill(c) é um manipulador de <iomanip>. A expressão out << std::setfill(c) altera o estado do fluxo como se fosse chamado out.fill(c); não escreve caracteres por si própria. A função devolve um objeto de tipo não especificado, enquanto a expressão completa com << devolve uma referência a out, permitindo encadear operações.
Quando a saída formatada precisa de preenchimento para atingir a largura do campo, o fluxo usa o carácter definido. std::setw(n) especifica uma largura mínima, não um limite de comprimento: o texto mais longo não é truncado. Para texto, std::right coloca o preenchimento antes do conteúdo e std::left coloca-o depois. std::setfill, por si só, não define nem a largura nem o alinhamento.
O carácter de preenchimento mantém-se definido para as operações seguintes, enquanto a inserção de caracteres e cadeias repõe a largura do campo a zero. Por isso, repita std::setw antes de cada campo que precise de preenchimento. Se um fluxo for partilhado, guarde o carácter anterior com out.fill() e restaure-o com out.fill(previous); isto não restaura as outras definições de formatação.
O tipo de c tem de corresponder ao tipo de carácter do fluxo: use, por exemplo, '.' para um fluxo char e L'.' para um fluxo wchar_t. O exemplo mostra que o carácter de preenchimento persiste e apresenta os dois sentidos de alinhamento. A especificação de std::setfill encontra-se na secção [std.manip] do projeto de norma C++.
Exemplos
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
const char previous = out.fill();
out << std::setfill('.') << std::right
<< std::setw(5) << "A" << '|'
<< std::setw(5) << "BC" << '|'
<< std::left << std::setw(5) << "D";
out.fill(previous);
std::cout << out.str() << '\n';
}
Resultado
....A|...BC|D....
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.