Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

static_assert — aserce při překladu

static_assert ověřuje během překladu konstantní podmínku. Nepravdivá podmínka vyhodnocená mimo kontext definice šablony způsobí, že program není správně utvořen, a vyžaduje diagnostiku. Volitelný řetězcový literál popisuje porušený předpoklad.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

static_assert(condition);
static_assert(condition, "message");

static_assert je deklarace, která během překladu ověřuje podmínku. Po kontextové konverzi na bool musí být podmínka konstantním výrazem. Aserce nemá žádný účinek, pokud má podmínka hodnotu true nebo se vyhodnocuje v kontextu definice šablony, a to i tehdy, má-li v tomto kontextu hodnotu false. V ostatních případech nepravdivá podmínka způsobí, že program není správně utvořen, a vyžaduje diagnostiku. Pro static_assert(false); v šabloně tedy není vyžadována diagnostika, pokud se tato aserce nikdy neinstanciuje.

C++23 podporuje podoby static_assert(condition); a static_assert(condition, "message");. Zpráva je volitelný řetězcový literál, nikoli text vypočítaný za běhu. Deklarace končí středníkem. Může se nacházet například ve třídě; v takovém případě nezavádí datový člen ani členskou funkci.

Příklad ověřuje, že capacity je kladná a sudá. Změna na 7 poruší druhou aserci. Neočekávejte, že všechny překladače formulují diagnostiku stejně.

Tento záznam se týká C++23. Uvedený web zveřejňuje průběžně se vyvíjející návrh, nikoli neměnný text C++23; novější rozšíření zpráv zde nejsou zahrnuta. Příznak překladače v repozitáři nepotvrzuje produkční prostředí.

Příklady

constexpr int capacity = 8;
static_assert(capacity > 0, "capacity must be positive");
static_assert(capacity % 2 == 0);

int main() {
    return 0;
}

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje