Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje