...
Eroare C++ · Avertismente (warnings) frecvente

warning: declaration shadows a local variable

Pe scurt

Ai declarat într-un bloc interior o variabilă cu același nume ca una din exterior (de obicei repetând int în buclă). Cea interioară o ascunde pe cea exterioară, care rămâne neschimbată. Șterge tipul ca să folosești variabila existentă sau dă-i alt nume.

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

Ce înseamnă

Fiecare bloc { ... } poate declara propriile variabile. Dacă în buclă scrii int total = 0;, deși total există deja în afara buclei, creezi o variabilă nouă, care o ascunde pe cea veche până la finalul blocului. Toate modificările se fac pe cea nouă, iar cea din exterior rămâne cum era. Codul e valid, de aceea compilatorul doar avertizează: declaration shadows a local variable, cu nota previous declaration is here spre variabila ascunsă.

Avertismentul vine din -Wshadow, care nu e inclus în -Wall: trebuie activat explicit (sau cu -Wshadow-all). Merită activat, pentru că greșeala dă rezultate greșite fără nicio eroare.

Variante înrudite: declaration shadows a field of 'Produs' (un parametru sau o variabilă locală cu numele unui câmp) și declaration shadows a variable in the global namespace.

De ce apare: cauzele frecvente

1Tipul repetat în buclă

Greșit
C++
int total = 0;
for (int p : preturi) {
    int total = 0;
    total += p;
}
Corect
C++
int total = 0;
for (int p : preturi) {
    total += p;
}

Fără int, instrucțiunea modifică variabila existentă, nu creează una nouă.

2Parametru cu numele unui câmp

Greșit
C++
struct Produs {
    int pret;
    void seteaza(int pret) { pret = pret; }
};
Corect
C++
struct Produs {
    int pret;
    void seteaza(int pretNou) { pret = pretNou; }
};

În varianta greșită parametrul ascunde câmpul, iar pret = pret se atribuie sieși.

3Variabilă refolosită într-un if

Greșit
C++
int rezultat = 0;
if (ok) {
    int rezultat = calculeaza();
}
Corect
C++
int rezultat = 0;
if (ok) {
    rezultat = calculeaza();
}

Variabila din if dispare la }, iar rezultatul calculului se pierde.

Repară tu

Repară eroarea, direct în pagină

Prima linie (#pragma) transformă avertismentul în eroare. Programul afișează subtotalurile unui coș, dar în buclă e declarată din nou variabila total, iar compilarea dă declaration shadows a local variable. Repară bucla ca programul să afișeze Subtotal: 10, Subtotal: 30, Subtotal: 60 și Total: 60, pe rânduri separate.

Codul care dă eroarea
C++
#pragma clang diagnostic error "-Wshadow"
#include <iostream>
using namespace std;

int main() {
    int preturi[] = {10, 20, 30};
    int total = 0;
    for (int p : preturi) {
        int total = 0;
        total += p;
        cout << "Subtotal: " << total << "\n";
    }
    cout << "Total: " << total << "\n";
    return 0;
}
După reparație, programul afișează
Subtotal: 10
Subtotal: 30
Subtotal: 60
Total: 60
Indiciu

Șterge declarația int total = 0; din interiorul buclei.

Alte forme ale mesajului

  • warning: declaration shadows a local variable [-Wshadow] note: previous declaration is here
  • warning: declaration of 'total' shadows a previous local [-Wshadow]
  • warning: declaration shadows a field of 'Produs' [-Wshadow-field-in-constructor]
  • warning: declaration shadows a variable in the global namespace [-Wshadow]

Cum o eviți pe viitor

  • Compilează cu -Wall -Wextra -Wshadow.
  • Când actualizezi o variabilă existentă, nu repeta tipul.
  • Dă nume distincte parametrilor și câmpurilor (pretNou, sau câmpuri cu prefix/sufix, de exemplu pret_).
  • Ține blocurile scurte, ca să vezi ușor ce variabile există deja.

Întrebări frecvente

De ce nu primesc avertismentul cu -Wall?

-Wshadow nu e inclus în -Wall și nici în -Wextra, pentru că uneori ascunderea e intenționată. Trebuie adăugat explicit.

Variabila din interior e ștearsă la final?

Da. La } variabila interioară dispare, iar numele indică din nou variabila exterioară, cu valoarea pe care o avea înainte de bloc.

Erori înrudite

← Toate erorile 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ță 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.