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

CKTIS / C++

std::format: formatação tipada para uma nova string

std::format cria um novo std::string a partir de um padrão verificado e dos seus argumentos.

Versão: C++23

Sintaxe

template<class... Args>
std::string std::format(std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(std::wformat_string<Args...> fmt, Args&&... args);

template<class... Args>
std::string std::format(const std::locale& loc,
    std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(const std::locale& loc,
    std::wformat_string<Args...> fmt, Args&&... args);

std::format(fmt, args...) de <format> devolve um novo std::string com as representações dos argumentos nos campos de substituição; a variante de caracteres largos devolve std::wstring e outras sobrecargas aceitam std::locale. Em C++23 uma chamada normal usa format_string<Args...>, cujo literal é verificado na compilação face ao número e tipos de argumentos.

O exemplo formata 7 como 0007, 3.5 com duas casas fracionárias e chavetas duplicadas como texto literal, imprimindo 0007 3.50 {ok}. {} escolhe o argumento seguinte e a parte após : controla alinhamento, largura, precisão e tipo de apresentação. std::format devolve uma string separada; std::format_to escreve através de um iterador de saída.

Chavetas literais escrevem-se {{ e }}; não se pode misturar numeração automática {} com manual {0}. Um literal inválido ou especificador incompatível normalmente torna a chamada mal formada na compilação. Para um padrão conhecido apenas em execução usa std::vformat. O próprio std::format também pode lançar std::format_error por uma falha dependente de valores detetada em execução, como largura ou precisão dinâmica inválida; exceções das operações do formatter propagam-se e a alocação pode lançar std::bad_alloc. Um tipo próprio exige uma especialização válida de std::formatter; a formatação regional usa a sobrecarga std::locale e opções adequadas.

Exemplos

#include <format>
#include <iostream>

int main() {
    std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}

Resultado

0007 3.50 {ok}

std::format → 0007 3.50 {ok}

Fontes