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

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.

Fontes