Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::format_error — wyjątek błędu formatowania

std::format_error z nagłówka <format> sygnalizuje błędy biblioteki formatowania. Poznaj różnicę między wyjątkiem podczas wykonania a odrzuceniem niepoprawnego formatu podczas kompilacji oraz sposób bezpiecznego przechwytywania tego wyjątku.

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

Składnia

#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 jest klasą wyjątku zadeklarowaną w <format>, publicznie dziedziczącą po std::runtime_error. Służy do zgłaszania błędów biblioteki formatowania. Przechwytuj ją przez const std::format_error&, aby nie kopiować obiektu i zachować dostęp do komunikatu przez what().

Dwa jawne konstruktory przyjmują const std::string& albo const char*. Dla własnoręcznie utworzonego wyjątku what() zwraca tekst zgodny z przekazanym łańcuchem zakończonym znakiem zerowym. Nie zakładaj jednak konkretnego brzmienia komunikatów wyjątków generowanych przez bibliotekę; przykład wypisuje własny, stały komunikat.

W C++23 niepoprawny literał przekazany do std::format, np. std::format("{:d}", "hello"), powoduje błąd kompilacji, a nie wyjątek możliwy do przechwycenia. Do formatowania wzorcem dostępnym podczas wykonania służy std::vformat z std::make_format_args. W przykładzie {:d} wymaga liczby całkowitej, lecz argument jest łańcuchem, więc zostaje zgłoszony std::format_error. Argument value pozostaje przy życiu przez całe wywołanie.

Nie każdy wyjątek z formatowania jest typu std::format_error: wyjątki z formatterów i iteratorów są propagowane, a błędy alokacji są zgłaszane osobno. Cytowany szkic standardu jest aktualizowany i pokazuje również zmiany późniejsze niż C++23; podana składnia nie przypisuje konstruktorom constexpr. Flaga kompilatora C++23 w repozytorium nie potwierdza obsługi biblioteki w środowisku produkcyjnym.

Przykłady

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

Wynik

format_error caught

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła