CKTIS / C++
static_assert — asercja sprawdzana podczas kompilacji
static_assert sprawdza warunek stały podczas kompilacji. Fałszywy warunek poza kontekstem definicji szablonu czyni program niepoprawnym i wymaga diagnostyki. Opcjonalny literał tekstowy opisuje naruszone założenie.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
static_assert(condition);
static_assert(condition, "message");static_assert jest deklaracją sprawdzającą warunek podczas kompilacji. Po konwersji kontekstowej do bool warunek musi być wyrażeniem stałym. Asercja nie ma skutku, jeśli warunek ma wartość true lub jest obliczany w kontekście definicji szablonu, nawet jeśli ma wtedy wartość false. W pozostałych przypadkach fałszywy warunek czyni program niepoprawnym i wymaga diagnostyki. Kompilator nie musi więc zgłaszać błędu z powodu static_assert(false); w szablonie, jeśli ta asercja nigdy nie zostanie zinstancjonowana.
W C++23 dostępne są postacie static_assert(condition); oraz static_assert(condition, "message");. Komunikat jest opcjonalnym literałem tekstowym, a nie tekstem obliczanym podczas wykonania. Deklaracja kończy się średnikiem. Można umieścić ją między innymi w klasie; nie tworzy wtedy pola ani funkcji składowej.
Przykład sprawdza dodatnią, parzystą wartość capacity. Zmiana na 7 narusza drugą asercję. Nie należy oczekiwać identycznego brzmienia diagnostyki we wszystkich kompilatorach.
Zakres wpisu to C++23. Podany serwis publikuje rozwijany szkic, nie zamrożony tekst C++23; nowszych rozszerzeń komunikatów nie uwzględniono. Flaga kompilatora w repozytorium nie potwierdza środowiska produkcyjnego.
Przykłady
constexpr int capacity = 8;
static_assert(capacity > 0, "capacity must be positive");
static_assert(capacity % 2 == 0);
int main() {
return 0;
}
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.