CKTIS / C++
std::format_error — výnimka pri chybe formátovania
std::format_error deklarovaná v <format> oznamuje chyby formátovacej knižnice. Spoznajte rozdiel medzi výnimkou počas behu programu a odmietnutím neplatného formátovacieho reťazca pri kompilácii a zistite, ako túto výnimku bezpečne zachytiť.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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 trieda výnimky deklarovaná v <format>, ktorá verejne dedí z std::runtime_error. Oznamuje chyby formátovacej knižnice. Zachytávajte ju ako const std::format_error&, aby ste objekt nemuseli kopírovať a zachovali si prístup k diagnostickej správe prostredníctvom what().
Jej dva explicitné konštruktory prijímajú const std::string& alebo const char*. Pri výnimke, ktorú vytvoríte sami, vracia what() text zodpovedajúci odovzdanému reťazcu ukončenému nulovým znakom. Nepredpokladajte však konkrétne znenie diagnostických správ pri výnimkách vytvorených knižnicou; príklad vypisuje vlastnú pevnú správu.
V C++23 spôsobí neplatný literál odovzdaný do std::format, napríklad std::format("{:d}", "hello"), chybu kompilácie, nie zachytiteľnú výnimku. Pre vzor dostupný až počas behu použite std::vformat s std::make_format_args. V príklade vyžaduje {:d} celé číslo, argumentom je však reťazec, a preto sa vyvolá std::format_error. Argument value zostáva platný počas celého volania.
Nie každá výnimka pri formátovaní je typu std::format_error: výnimky z formátovačov a iterátorov sa propagujú, zatiaľ čo chyby alokácie sa oznamujú samostatne. Citovaný pracovný návrh sa vyvíja a uvádza aj zmeny po C++23; uvedená syntax neoznačuje konštruktory ako constexpr. Príznak kompilátora C++23 v repozitári nedokladá podporu knižnice v produkčnom prostredí.
Prí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ýsledok
format_error caught
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.