...
Eroare Limbajul C · Nume, declarații și #include

error: static assertion failed due to requirement 'NR_LUNI == 12': trebuie 12 luni

Pe scurt

Un _Static_assert (sau static_assert) a verificat la compilare o condiție și a găsit-o falsă, așa că programul nu se compilează. Mesajul arată condiția și textul scris de programator. Repară datele sau tipurile care fac condiția falsă; nu șterge verificarea.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

_Static_assert(conditie, "mesaj") (C11) sau static_assert (din assert.h, iar în C23 cuvânt cheie) e un assert care rulează la compilare. Condiția trebuie să fie o expresie constantă: sizeof, constante, enum-uri. Dacă e falsă, clang oprește compilarea cu static assertion failed due to requirement '...', urmat de textul tău.

Se folosește pentru reguli pe care codul se bazează: un tabel trebuie să aibă exact 12 elemente, o structură trimisă prin rețea trebuie să aibă 8 octeți, un int trebuie să aibă cel puțin 32 de biți. Dacă cineva adaugă un câmp sau șterge un element, eroarea apare imediat, nu la rulare.

Când îl primești, citește condiția din mesaj și calculează de mână fiecare parte: de obicei un tablou are un element lipsă sau în plus, sau o structură are padding la care nu te așteptai.

De ce apare: cauzele frecvente

1Lipsește un element din tabel

Greșit
C
const char *luni[] = {"Ian", "Feb", "Mar", "Apr", "Mai", "Iun",
                      "Iul", "Aug", "Sep", "Oct", "Noi"};
_Static_assert(sizeof luni / sizeof luni[0] == 12, "trebuie 12 luni");
Corect
C
const char *luni[] = {"Ian", "Feb", "Mar", "Apr", "Mai", "Iun",
                      "Iul", "Aug", "Sep", "Oct", "Noi", "Dec"};
_Static_assert(sizeof luni / sizeof luni[0] == 12, "trebuie 12 luni");

Tabloul are 11 elemente, deci condiția e falsă. Cu „Dec” adăugat are 12.

2Padding în structură

Greșit
C
struct Mesaj { char tip; int valoare; };
_Static_assert(sizeof(struct Mesaj) == 5, "5 octeti");
Corect
C
struct Mesaj { int valoare; char tip; char rezerva[3]; };
_Static_assert(sizeof(struct Mesaj) == 8, "8 octeti");

Compilatorul aliniază int la 4 octeți și adaugă padding. Regula trebuie să țină cont de dimensiunea reală.

3Condiție care nu e constantă

Greșit
C
int n = 12;
_Static_assert(n == 12, "n");
Corect
C
enum { N = 12 };
_Static_assert(N == 12, "N");

O variabilă obișnuită nu e cunoscută la compilare. Folosește un enum sau un #define (altfel primești expression is not an integral constant expression).

Repară tu

Repară eroarea, direct în pagină

Programul are lista lunilor anului și verifică la compilare că are 12 elemente, dar compilarea se oprește cu static assertion failed. Completează lista ca programul să afișeze Luni: 12, ultima: Dec.

Codul care dă eroarea
C
#include <stdio.h>

const char *luni[] = {"Ian", "Feb", "Mar", "Apr", "Mai", "Iun",
                      "Iul", "Aug", "Sep", "Oct", "Noi"};
#define NR_LUNI (sizeof luni / sizeof luni[0])
_Static_assert(NR_LUNI == 12, "trebuie 12 luni");

int main(void) {
    printf("Luni: %d, ultima: %s\n", (int)NR_LUNI, luni[NR_LUNI - 1]);
    return 0;
}
După reparație, programul afișează
Luni: 12, ultima: Dec
Indiciu

Numără elementele: lipsește ultima lună.

Alte forme ale mesajului

  • error: static assertion failed: "trebuie 12 luni"
  • error: static_assert failed due to requirement 'NR_LUNI == 12' "trebuie 12 luni"
  • error: static assertion expression is not an integral constant expression
  • note: expression evaluates to '11 == 12'

Cum o eviți pe viitor

  • Folosește _Static_assert pentru reguli despre tipuri și tabele constante, assert pentru reguli la rulare.
  • Scrie un mesaj clar, care spune ce trebuie să fie adevărat.
  • Calculează lungimea tablourilor cu sizeof v / sizeof v[0], nu cu numere scrise de mână.
  • Când eroarea apare după o modificare, uită-te întâi la elementele adăugate sau șterse.

Întrebări frecvente

Care e diferența față de assert?

assert verifică la rulare și oprește programul cu Assertion failed. _Static_assert verifică la compilare și nici nu lasă programul să fie construit. Cel static merge doar cu expresii constante.

Scriu static_assert sau _Static_assert?

În C11 numele cuvântului cheie e _Static_assert; static_assert e un macro din assert.h. În C23 static_assert e cuvânt cheie și mesajul e opțional. Ambele dau aceeași eroare.

Erori înrudite

← Toate erorile Limbajul C

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Limbajul C de la zero, cu exerciții la fiecare lecție

Curs C: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.