Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::format_error — izjema pri napaki oblikovanja

std::format_error, deklariran v <format>, sporoča napake knjižnice za oblikovanje. Spoznajte razliko med izjemo med izvajanjem in zavrnitvijo neveljavnega oblikovnega niza med prevajanjem ter se naučite to izjemo varno ujeti.

Različica: 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 razred izjem, deklariran v <format>, ki javno izhaja iz std::runtime_error. Sporoča napake knjižnice za oblikovanje. Ujemite ga kot const std::format_error&, da se izognete kopiranju objekta in ohranite dostop do diagnostičnega sporočila prek what().

Njegova izrecna konstruktorja sprejemata const std::string& ali const char*. Pri izjemi, ki jo ustvarite sami, what() vrne besedilo, ki ustreza podanemu nizu, zaključenemu z ničelnim znakom. Vendar ne predpostavljajte določenega besedila diagnostičnih sporočil za izjeme, ki jih ustvari knjižnica; primer izpiše lastno stalno sporočilo.

V C++23 neveljaven literal, posredovan funkciji std::format, na primer std::format("{:d}", "hello"), povzroči napako pri prevajanju, ne pa izjeme, ki bi jo bilo mogoče ujeti. Za vzorec, ki je na voljo med izvajanjem, uporabite std::vformat z std::make_format_args. V primeru {:d} zahteva celo število, argument pa je niz, zato se sproži std::format_error. Argument value ostane veljaven ves čas klica.

Ni vsaka izjema pri oblikovanju tipa std::format_error: izjeme oblikovalnikov in iteratorjev se posredujejo naprej, napake pri dodeljevanju pomnilnika pa se sporočajo ločeno. Navedeni delovni osnutek se spreminja in prikazuje tudi spremembe po C++23; navedena sintaksa konstruktorjev ne označuje kot constexpr. Zastavica prevajalnika C++23 v repozitoriju ne potrjuje podpore knjižnice v produkcijskem okolju.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri