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.