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}