CKTIS / C++
Vstupné podmienky a doménové invarianty
Rozlišujte povinnosti volajúceho od pravidiel platného stavu objektu. Externé vstupy overujte nezávisle od `assert` a invariant chráňte verejným rozhraním typu.
Verzia: ISO C++23; implementation support may vary
Syntax
// 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.Vstupná podmienka operácie musí platiť pred jej použitím; zodpovedá za to volajúci. Napríklad limit->get() vyžaduje, aby limit obsahoval hodnotu. Doménový invariant opisuje platný stav objektu: každý Limit musí uchovávať číslo od 1 do 100 vrátane. Konštrukcia objektu invariant ustanoví a verejné operácie ho zachovávajú.
V C++23 je assert(condition) z <cassert> makro, nie funkcia std::assert. Ak je aktívne, vyhodnotí podmienku. Ak je výsledkom nula (vrátane false), vypíše diagnostiku na štandardný chybový výstup a zavolá std::abort(). Ak je pri zahrnutí <cassert> definované NDEBUG, výraz sa nevyhodnotí. Do assert nepatrí validácia externých vstupov ani nevyhnutné vedľajšie účinky.
static_assert je deklarácia kontrolovaná pri preklade nezávisle od NDEBUG. Tu overuje vzťah medzi konštantnými hranicami: nepravdivá podmienka znamená, že program nie je správne utvorený. Hodnotu získanú počas vykonávania nekontroluje.
Limit::make kontroluje rozsah obyčajným if a pri odmietnutí vráti std::nullopt. Verejný konštruktor bez kontroly alebo zapisovateľný verejný dátový člen by umožnil obísť továrenskú funkciu alebo narušiť platný stav objektu. Súkromný konštruktor prijímajúci celé číslo a súkromný člen, do ktorého rozhranie neumožňuje zapísať ľubovoľnú hodnotu, tieto cesty uzatvárajú. get() vracia kópiu čísla; jeho assert slúži len na odhalenie internej chyby.
Príklady
#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);
}Výsledok
0: rejected 42: accepted 42 101: rejected
Celé čísla `0`, `42` a `101` predstavujú už načítané vstupy. `if (limit)` overí prítomnosť hodnoty pred použitím `->`. Očakávaný výstup je rovnaký s `NDEBUG` aj bez neho.
Súvisiace lekcie
- C++ · Lekcia 52 · Pokročilá · Verzia: 3