error: static assertion failed due to requirement 'NR_LUNI == 12': trebuie 12 luni
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
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");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ă
struct Mesaj { char tip; int valoare; };
_Static_assert(sizeof(struct Mesaj) == 5, "5 octeti");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ă
int n = 12;
_Static_assert(n == 12, "n");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ă 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.
#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;
}Luni: 12, ultima: Dec
Indiciu
Numără elementele: lipsește ultima lună.
Reparația
#include <stdio.h>
const char *luni[] = {"Ian", "Feb", "Mar", "Apr", "Mai", "Iun",
"Iul", "Aug", "Sep", "Oct", "Noi", "Dec"};
#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;
}De ce merge
sizeof luni / sizeof luni[0] dă numărul real de elemente, calculat la compilare. Cu 11 luni condiția NR_LUNI == 12 era falsă și _Static_assert a oprit construirea programului. Cu „Dec” adăugat, tabloul are 12 elemente, verificarea trece, iar luni[11] este 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 expressionnote: expression evaluates to '11 == 12'
Cum o eviți pe viitor
- Folosește
_Static_assertpentru reguli despre tipuri și tabele constante,assertpentru 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
main: main.c:9: main: Assertion `stoc >= 0' failed. Un assert din cod a găsit condiția falsă și a oprit programul (Aborted). Mesajul arată fișierul, linia și condiția. Nu șterge assert-ul: află de ce condiția a ajuns falsă (o valoare greșită mai devreme) și repară acea cauză. error: expression is not an integer constant expression Într-un loc unde C cere o constantă cunoscută la compilare (eticheta unui case, dimensiunea unui tablou global, valoarea unui enum) ai pus o variabilă. Folosește un literal, un #define sau o valoare dintr-un enum; dacă valoarea se află abia la rulare, înlocuiește switch cu if. warning: excess elements in array initializer Ai pus între acolade mai multe valori decât încap în tablou, de exemplu int v[3] = {1, 2, 3, 4};. Valorile în plus sunt aruncate. Mărește dimensiunea, șterge valorile în plus sau lasă parantezele goale (int v[] = {...}) ca dimensiunea să fie calculată automat. Î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.
