warning: ignoring return value of function declared with 'warn_unused_result' attribute
Ai apelat o funcție marcată warn_unused_result (sau [[nodiscard]]) fără să folosești ce întoarce. Valoarea e de obicei un cod de eroare sau un rezultat nou (de ex. realloc, scanf, fread). Pune rezultatul într-o variabilă și verifică-l.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Atributul __attribute__((warn_unused_result)) (în C23, [[nodiscard]]) spune compilatorului: „rezultatul acestei funcții contează; dacă îl ignori, e aproape sigur o greșeală”. Clang avertizează ignoring return value of function declared with 'warn_unused_result' attribute (sau ... with 'nodiscard' attribute), iar GCC ignoring return value of 'scanf' declared with attribute 'warn_unused_result'.
Pe Linux, glibc marchează astfel funcții ca scanf, fread, fgets, write, realloc, system, mai ales când compilezi cu -O2 -D_FORTIFY_SOURCE=2. În propriul cod, îl pui la funcțiile care întorc un cod de eroare (0 = succes, -1 = eșec) sau un pointer nou.
Nu „repara” avertismentul cu un cast la (void) decât dacă ești sigur că rezultatul chiar nu contează. De cele mai multe ori trebuie verificat: o retragere refuzată, o citire eșuată, un realloc care a întors NULL.
De ce apare: cauzele frecvente
1Cod de eroare ignorat
retrage(&sold, 500);
printf("Retras\n");if (retrage(&sold, 500) != 0)
printf("Fonduri insuficiente\n");
else
printf("Retras\n");Funcția spune dacă operația a reușit; programul trebuie să reacționeze la eșec.
2realloc al cărui rezultat se pierde
realloc(v, 20 * sizeof(int));int *nou = realloc(v, 20 * sizeof(int));
if (nou == NULL) { free(v); return 1; }
v = nou;realloc poate muta blocul la altă adresă. Fără să păstrezi rezultatul, v poate rămâne un pointer invalid.
3scanf fără verificare
scanf("%d", &n);if (scanf("%d", &n) != 1) {
printf("Numar invalid\n");
return 1;
}scanf întoarce câte valori a citit. Dacă textul nu e un număr, n rămâne neinițializat.
Repară eroarea, direct în pagină
Funcția retrage întoarce 0 la succes și -1 când nu sunt bani destui și e marcată warn_unused_result. main o apelează fără să verifice rezultatul, așa că apare ignoring return value of function declared with 'warn_unused_result' attribute. Verifică rezultatul ca programul să afișeze Fonduri insuficiente, sold 300.
#pragma clang diagnostic error "-Wunused-result"
#include <stdio.h>
__attribute__((warn_unused_result))
int retrage(int *sold, int suma) {
if (suma > *sold)
return -1;
*sold -= suma;
return 0;
}
int main(void) {
int sold = 300;
retrage(&sold, 500);
printf("Retras, sold %d\n", sold);
return 0;
}Fonduri insuficiente, sold 300
Indiciu
Pune apelul într-un if și afișează mesajul când rezultatul nu e 0.
Reparația
#pragma clang diagnostic error "-Wunused-result"
#include <stdio.h>
__attribute__((warn_unused_result))
int retrage(int *sold, int suma) {
if (suma > *sold)
return -1;
*sold -= suma;
return 0;
}
int main(void) {
int sold = 300;
if (retrage(&sold, 500) != 0)
printf("Fonduri insuficiente, sold %d\n", sold);
else
printf("Retras, sold %d\n", sold);
return 0;
}De ce merge
Atributul warn_unused_result spune că rezultatul lui retrage trebuie folosit. Programul vechi afișa „Retras” chiar dacă retragerea de 500 din 300 fusese refuzată. Cu if (retrage(...) != 0), programul vede codul -1 și afișează mesajul corect, iar soldul rămâne 300. Fără verificare, eșecul ar fi trecut neobservat, exact ce încearcă atributul să prevină.
Alte forme ale mesajului
warning: ignoring return value of function declared with 'warn_unused_result' attribute [-Wunused-result]warning: ignoring return value of function declared with 'nodiscard' attribute [-Wunused-result]warning: ignoring return value of 'scanf' declared with attribute 'warn_unused_result' [-Wunused-result]warning: ignoring return value of 'realloc' declared with attribute 'warn_unused_result' [-Wunused-result]
Cum o eviți pe viitor
- Verifică întotdeauna rezultatul funcțiilor care pot eșua:
scanf,fopen,malloc,realloc,fread. - Marchează-ți funcțiile care întorc coduri de eroare cu
__attribute__((warn_unused_result))sau[[nodiscard]]. - Când chiar vrei să ignori rezultatul, scrie explicit
(void)functie();și un comentariu cu motivul. - Compilează cu
-Wall -Wextrași, la release, cu-D_FORTIFY_SOURCE=2.
Întrebări frecvente
De ce văd avertismentul doar pe Linux?
glibc adaugă warn_unused_result la funcții ca scanf și fread doar în anumite configurări (de exemplu cu optimizare și _FORTIFY_SOURCE). Pe macOS sau Windows aceleași funcții nu au atributul, dar rezultatul trebuie verificat la fel.
(void) chiar ascunde avertismentul?
La clang, da, iar la GCC, pentru warn_unused_result, cast-ul la void nu ajunge întotdeauna. Oricum, soluția bună e să folosești rezultatul, nu să ascunzi avertismentul.
Erori înrudite
warning: equality comparison result unused Ai scris == pe o linie singură, de exemplu stoc == stoc - 1;. Comparația se calculează și rezultatul se pierde, deci variabila nu se schimbă. Aproape sigur voiai atribuirea: stoc = stoc - 1; (sau stoc--). error: non-void function 'cauta' should return a value Funcția are un tip (int, double, pointer), dar ai scris return; fără valoare. Apelantul ar primi o valoare nedefinită. Pune după return valoarea potrivită, de exemplu return -1; pentru „negăsit” sau return NULL; la pointeri. warning: unused variable 'rest' Ai declarat o variabilă pe care nu o folosești nicăieri. Codul compilează, dar de multe ori e semnul unei greșeli: ai calculat ceva și ai afișat altă variabilă, sau ai uitat un pas. Folosește variabila acolo unde trebuia sau șterge-o. Î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.
