Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła