Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje