CKTIS / C++
std::format_error — výjimka při chybě formátování
std::format_error deklarovaná v <format> oznamuje chyby formátovací knihovny. Poznejte rozdíl mezi výjimkou za běhu a odmítnutím neplatného formátovacího řetězce při kompilaci a zjistěte, jak tuto výjimku bezpečně zachytit.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 je třída výjimky deklarovaná v <format>, která veřejně dědí z std::runtime_error. Oznamuje chyby formátovací knihovny. Zachytávejte ji jako const std::format_error&, abyste objekt nemuseli kopírovat a zachovali si přístup k diagnostické zprávě prostřednictvím what().
Její dva explicitní konstruktory přijímají const std::string& nebo const char*. U výjimky, kterou vytvoříte sami, vrací what() text odpovídající předanému řetězci ukončenému nulovým znakem. Nepředpokládejte však konkrétní znění diagnostických zpráv u výjimek vytvářených knihovnou; příklad vypisuje vlastní pevně danou zprávu.
V C++23 způsobí neplatný literál předaný do std::format, například std::format("{:d}", "hello"), chybu kompilace, nikoli zachytitelnou výjimku. Pro vzor dostupný až za běhu použijte std::vformat s std::make_format_args. V příkladu vyžaduje {:d} celé číslo, argumentem je však řetězec, a proto se vyvolá std::format_error. Argument value zůstává platný po celou dobu volání.
Ne každá výjimka při formátování je typu std::format_error: výjimky z formátovačů a iterátorů se propagují, zatímco chyby alokace se oznamují samostatně. Citovaný pracovní návrh se vyvíjí a uvádí také změny po C++23; uvedená syntaxe neoznačuje konstruktory jako constexpr. Příznak kompilátoru C++23 v repozitáři nedokládá podporu knihovny v produkčním prostředí.
Příklady
#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;
}
Výsledek
format_error caught
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.