CKTIS / C++
std::format_error — изключение при грешка във форматирането
std::format_error, деклариран в <format>, сигнализира за грешки в библиотеката за форматиране. Научете разликата между изключение по време на изпълнение и отхвърляне при компилация на невалиден низ за форматиране, както и как безопасно да прихващате това изключение.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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 е клас на изключение, деклариран в <format>, който публично наследява std::runtime_error. Той сигнализира за грешки в библиотеката за форматиране. Прихващайте го като const std::format_error&, за да избегнете копирането на обекта и да запазите достъпа до диагностичното съобщение чрез what().
Двата му явни конструктора приемат const std::string& или const char*. За изключение, което създавате сами, what() връща текст, съответстващ на подадения низ, завършващ с нулев знак. Не приемайте обаче, че изключенията, генерирани от библиотеката, имат определен текст на диагностичното съобщение; примерът отпечатва собствено фиксирано съобщение.
В C++23 невалиден литерал, подаден на std::format, например std::format("{:d}", "hello"), причинява грешка при компилация, а не прихващаемо изключение. За шаблон, наличен по време на изпълнение, използвайте std::vformat с std::make_format_args. В примера {:d} изисква цяло число, но аргументът е низ, затова се хвърля std::format_error. Аргументът value остава валиден през цялото извикване.
Не всяко изключение при форматиране е std::format_error: изключенията от форматери и итератори се разпространяват, а грешките при заделяне на памет се съобщават отделно. Цитираният работен проект се променя и показва също промени след C++23; посоченият синтаксис не отбелязва конструкторите като constexpr. Флаг за компилатор C++23 в хранилището не удостоверява поддръжка на библиотеката в производствената среда.
Примери
#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;
}
Резултат
format_error caught
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.