База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници