CKTIS / C++
Predpogoji in domenske invariante
Ločite obveznosti klicatelja od pravil o veljavnem stanju objekta. Zunanje vhode preverjajte neodvisno od `assert`, invarianto pa ohranite z javnim vmesnikom tipa.
Različica: ISO C++23; implementation support may vary
Sintaksa
// ISO C++23: assert is a macro, not std::assert.
#include <cassert>
assert(condition);
static_assert(constant_condition);
static_assert(constant_condition, "message");
// To disable assert, define NDEBUG before including <cassert>.
// Preconditions and domain invariants are design rules, not C++23 declarations.Predpogoj mora veljati pred uporabo operacije; zanj je odgovoren klicatelj. Na primer, limit->get() zahteva, da limit vsebuje vrednost. Domenska invarianta opisuje veljavno stanje objekta: vsak Limit mora hraniti število od 1 do vključno 100. Konstrukcija objekta vzpostavi invarianto, javne operacije pa jo ohranjajo.
V C++23 je assert(condition) iz <cassert> makro, ne funkcija std::assert. Če je omogočen, ovrednoti pogoj. Če je rezultat nič (tudi false), izpiše diagnostično sporočilo na standardni tok za napake in pokliče std::abort(). Če je NDEBUG definiran ob vključitvi <cassert>, se izraz ne ovrednoti. V assert ne sodijo preverjanje zunanjih vhodov ali nujni stranski učinki.
static_assert je deklaracija, ki se preveri med prevajanjem neodvisno od NDEBUG. Tu preveri konstantni meji: če pogoj ne velja, program ni pravilno oblikovan. Vrednosti, pridobljene med izvajanjem, ne preverja.
Limit::make preveri obseg z navadnim if in ob zavrnitvi vrne std::nullopt. Javni konstruktor brez preverjanja ali zapisljivo javno polje bi omogočila obhod tovarniške funkcije ali spremembo veljavnega objekta v neveljavnega. Zasebni konstruktor, ki sprejme celo število, in zasebno polje, ki mu prek vmesnika ni mogoče dodeliti poljubne vrednosti, zapreta ti poti. get() vrne kopijo števila; njegov assert je namenjen le odkrivanju notranje napake.
Primeri
#include <cassert>
#include <iostream>
#include <optional>
class Limit {
static constexpr int min_value = 1;
static constexpr int max_value = 100;
static_assert(min_value <= max_value);
int value_;
explicit Limit(int value) noexcept : value_(value) {}
static constexpr bool in_range(int value) noexcept {
return min_value <= value && value <= max_value;
}
public:
static std::optional<Limit> make(int value) noexcept {
if (!in_range(value)) {
return std::nullopt;
}
return Limit{value};
}
int get() const noexcept {
assert(in_range(value_));
return value_;
}
};
void report(int input) {
const auto limit = Limit::make(input);
if (limit) {
std::cout << input << ": accepted " << limit->get() << '\n';
} else {
std::cout << input << ": rejected\n";
}
}
int main() {
report(0);
report(42);
report(101);
}Rezultat
0: rejected 42: accepted 42 101: rejected
Cela števila `0`, `42` in `101` predstavljajo že prebrane vhode. `if (limit)` pred uporabo `->` preveri, ali je vrednost prisotna. Pričakovani izpis je enak z `NDEBUG` ali brez njega.
Povezane lekcije
- C++ · Lekcija 52 · Napredna · Različica: 3