Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::format_error — iznimka za pogrešku formatiranja

std::format_error, deklariran u <format>, prijavljuje pogreške biblioteke za formatiranje. Saznajte razliku između iznimke tijekom izvođenja i odbijanja nevaljanog niza formata pri prevođenju te kako sigurno uhvatiti tu iznimku.

Verzija: C++23; repository compiler flag, production runtime not attested

Sintaksa

#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 klasa iznimke deklarirana u <format> koja javno nasljeđuje std::runtime_error. Prijavljuje pogreške biblioteke za formatiranje. Uhvatite je kao const std::format_error& kako biste izbjegli kopiranje objekta i zadržali pristup dijagnostičkoj poruci putem what().

Njezina dva eksplicitna konstruktora prihvaćaju const std::string& ili const char*. Za iznimku koju sami stvorite, what() vraća tekst koji odgovara predanom nizu završenom nul-znakom. Ipak, nemojte pretpostavljati određeni tekst dijagnostičkih poruka za iznimke koje generira biblioteka; primjer ispisuje vlastitu fiksnu poruku.

U C++23 nevaljan literal predan funkciji std::format, primjerice std::format("{:d}", "hello"), uzrokuje pogrešku pri prevođenju, a ne iznimku koju je moguće uhvatiti. Za obrazac dostupan tijekom izvođenja upotrijebite std::vformat s std::make_format_args. U primjeru {:d} zahtijeva cijeli broj, ali argument je niz znakova, pa se izbacuje std::format_error. Argument value ostaje valjan tijekom cijelog poziva.

Nije svaka iznimka pri formatiranju tipa std::format_error: iznimke iz formatizatora i iteratora propagiraju se, dok se pogreške alokacije prijavljuju zasebno. Nacrt radnog teksta standarda koji se citira mijenja se i prikazuje i promjene nakon C++23; navedena sintaksa ne označava konstruktore kao constexpr. Zastavica prevoditelja C++23 u repozitoriju ne potvrđuje podršku biblioteke u produkcijskom okruženju.

Primjeri

#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;
}

Rezultat

format_error caught

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori