CKTIS / C++
Obravnava napak: omejeno ponavljanje in nadomestni rezultat
Obravnava napak loči zaznavo neuspeha od odločitve o naslednjem koraku. Deterministični primer s std::expected pojasni prehodne in trajne napake, omejeno ponavljanje, nadomestni rezultat in idempotentnost.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
std::expected<T, E>; std::unexpected{error_value}; result.has_value(); result.error(); *result; throw expression; try { /* ... */ } catch (const Exception& e) { /* ... */ }Obravnava napak pomeni sporočiti neuspeh in izrecno izbrati odziv. V C++23 std::expected<T, E> vsebuje vrednost ali napako. Pred uporabo *result preveri has_value(), error() pa kliči le v stanju napake. Izjeme uporabljajo throw in try/catch ter lahko predajo nadzor ustreznemu obravnavalniku. Noben od teh mehanizmov sam ne določa pravil za okrevanje. Navedeno spletišče objavlja osnutek, ki se še razvija, ne dokončne specifikacije C++23.
Prehodna ali trajna napaka: prehodna napaka, na primer začasna nedostopnost, lahko izgine brez spremembe zahteve. Pri odločanju o ponovitvi je napaka trajna, če ni pričakovati, da bo ponovitev iste operacije v nespremenjenih pogojih pomagala. Nepodprta operacija lahko na primer zahteva drugo implementacijo ali pa zanjo sploh ni rešitve. Razvrstitev je odvisna od pogodbe operacije, ne samodejno od vrste izjeme. Pri omejenem ponavljanju v omejitev šteje tudi prvi poskus: max_attempts = 3 dovoljuje največ dve ponovitvi. Končaj ob uspehu, trajni napaki ali doseženi omejitvi. Pri dejanskem I/O upoštevaj še skupni rok in premore med poskusi.
Idempotentnost pomeni, da ima ponovitev iste operacije enak predvideni učinek kot enkratna izvedba, ne nujno enakega odziva. Po izteku časovne omejitve je operacija morda že spremenila stanje. Ne ponavljaj plačil ali drugih operacij s stranskimi učinki na slepo: zahtevaj jamstvo idempotentnosti ali deduplikacijo zahtev. Nadomestni rezultat je izrecno sprejemljiv rezultat slabše kakovosti, ne uspeh prvotne operacije. Če noben nadomestek ni varen, posreduj napako naprej.
Primer simulira branje brez stranskih učinkov. run(false) po dveh prehodnih napakah v tretjem poskusu dobi 42. run(true) se ustavi ob prvi trajni napaki in obdrži fallback z vrednostjo 7, kot bi ga tudi ob doseženi omejitvi. Čakanje je namenoma izpuščeno, da je prikaz determinističen. V produkciji ohrani podatek o vzroku in uporabi nadomestka; primer ni celovita produkcijska politika.
Primeri
#include <expected>
#include <iostream>
enum class Error { transient, permanent };
std::expected<int, Error> fetch(int attempt, bool denied) {
if (denied) return std::unexpected(Error::permanent);
if (attempt < 3) return std::unexpected(Error::transient);
return 42;
}
void run(bool denied) {
constexpr int max_attempts = 3;
constexpr int fallback = 7;
int value = fallback;
int attempts = 0;
for (int attempt = 1; attempt <= max_attempts; ++attempt) {
++attempts;
auto result = fetch(attempt, denied);
if (result.has_value()) {
value = *result;
break;
}
if (result.error() == Error::permanent) break;
}
std::cout << "value=" << value << " attempts=" << attempts << '\n';
}
int main() {
run(false);
run(true);
}
Rezultat
value=42 attempts=3 value=7 attempts=1
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.