CKTIS / C++
std::format_error — exceção de erro de formatação
std::format_error, declarada em <format>, assinala erros da biblioteca de formatação. Saiba distinguir uma exceção em tempo de execução da rejeição, em compilação, de uma cadeia de formato inválida e aprenda a capturar esta exceção em segurança.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <format>
// C++23 constructor signatures:
// std::format_error publicly derives from std::runtime_error.
explicit format_error(const std::string& what_arg);
explicit format_error(const char* what_arg);
// Catch by const reference:
catch (const std::format_error& e) { /* handle formatting error */ }std::format_error é uma classe de exceção declarada em <format> que deriva publicamente de std::runtime_error. Assinala erros da biblioteca de formatação. Capture-a como const std::format_error& para evitar copiar o objeto e manter o acesso à mensagem de diagnóstico através de what().
Os seus dois construtores explícitos aceitam const std::string& ou const char*. Para uma exceção criada por si, what() devolve texto correspondente à cadeia terminada em nulo fornecida. No entanto, não pressuponha uma mensagem de diagnóstico específica para as exceções geradas pela biblioteca; o exemplo apresenta uma mensagem fixa própria.
Em C++23, um literal inválido passado a std::format, como std::format("{:d}", "hello"), provoca um erro de compilação, e não uma exceção que possa ser capturada. Utilize std::vformat com std::make_format_args para um padrão disponível em tempo de execução. No exemplo, {:d} exige um inteiro, mas o argumento é uma cadeia de caracteres, pelo que é lançada uma std::format_error. O argumento value mantém-se válido durante toda a chamada.
Nem todas as exceções de formatação são std::format_error: as exceções provenientes de formatadores e iteradores propagam-se, enquanto os erros de alocação são assinalados separadamente. O projeto de norma citado evolui e também apresenta alterações posteriores a C++23; a sintaxe indicada não assinala os construtores como constexpr. Uma opção de compilador C++23 no repositório não comprova o suporte da biblioteca no ambiente de produção.
Exemplos
#include <format>
#include <iostream>
#include <string>
int main() {
std::string pattern = "{:d}";
std::string value = "hello";
try {
std::cout << std::vformat(pattern, std::make_format_args(value)) << '\n';
} catch (const std::format_error&) {
std::cout << "format_error caught\n";
return 0;
}
return 1;
}
Resultado
format_error caught
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.