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

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.

Fontes