Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::format_error — eccezione per errore di formattazione

std::format_error, dichiarata in <format>, segnala gli errori della libreria di formattazione. Scopri la differenza tra un’eccezione a runtime e il rifiuto in compilazione di una stringa di formato non valida, e come intercettare l’eccezione in sicurezza.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#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 è una classe di eccezione dichiarata in <format> che deriva pubblicamente da std::runtime_error. Segnala gli errori della libreria di formattazione. Intercettala tramite const std::format_error& per evitare di copiare l’oggetto e mantenere l’accesso al messaggio diagnostico tramite what().

I suoi due costruttori espliciti accettano const std::string& oppure const char*. Per un’eccezione creata da te, what() restituisce un testo corrispondente alla stringa terminata da null fornita. Non presumere però che le eccezioni generate dalla libreria abbiano un messaggio diagnostico specifico; l’esempio stampa un proprio messaggio fisso.

In C++23, un letterale non valido passato a std::format, ad esempio std::format("{:d}", "hello"), causa un errore di compilazione, non un’eccezione intercettabile. Usa std::vformat con std::make_format_args per uno schema disponibile a runtime. Nell’esempio, {:d} richiede un intero, ma l’argomento è una stringa, quindi viene lanciata std::format_error. L’argomento value rimane valido per tutta la chiamata.

Non tutte le eccezioni di formattazione sono std::format_error: le eccezioni provenienti da formatter e iteratori si propagano, mentre gli errori di allocazione vengono segnalati separatamente. La bozza di lavoro citata evolve e mostra anche modifiche successive a C++23; la sintassi riportata non indica i costruttori come constexpr. Un’opzione del compilatore C++23 nel repository non attesta il supporto della libreria nell’ambiente di produzione.

Esempi

#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;
}

Risultato

format_error caught

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti