...
Eroare Solidity · Nume nedeclarate și membri inexistenți

DeclarationError: Undeclared identifier.

Pe scurt

Folosești un nume (variabilă, funcție, eveniment) pe care compilatorul nu îl găsește: e scris diferit față de declarație, nu a fost declarat sau nu e vizibil în acel loc. Verifică literele mari și mici și declarația.

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

Ce înseamnă

Compilatorul a întâlnit un nume și l-a căutat printre variabilele locale, parametrii, variabilele de stare, funcțiile și tipurile contractului (și ale părinților lui). Nu l-a găsit nicăieri, deci nu știe la ce te referi.

Cel mai des e o greșeală de scriere: totalvanzari în loc de totalVanzari. Solidity face diferența între literele mari și mici, așa că acestea sunt două nume diferite. Când găsește un nume asemănător, compilatorul te ajută: Undeclared identifier. Did you mean "totalVanzari"?.

Alte cauze: o variabilă locală folosită în afara blocului { } în care a fost declarată, o funcție external apelată din același contract (atunci mesajul spune "f" is not (or not yet) visible at this point) sau now, care a fost eliminat în 0.8 (folosește block.timestamp).

De ce apare: cauzele frecvente

1Numele e scris diferit față de declarație

Greșit
SOLIDITY
uint256 public totalVanzari;

function vinde() external {
    totalvanzari += 1;
}
Corect
SOLIDITY
uint256 public totalVanzari;

function vinde() external {
    totalVanzari += 1;
}

totalvanzari și totalVanzari sunt nume diferite. Compilatorul sugerează aici Did you mean "totalVanzari"?.

2Variabila locală e folosită în afara blocului ei

Greșit
SOLIDITY
function f(uint256 x) external pure returns (uint256) {
    if (x > 10) {
        uint256 bonus = 5;
    }
    return x + bonus;
}
Corect
SOLIDITY
function f(uint256 x) external pure returns (uint256) {
    uint256 bonus = 0;
    if (x > 10) {
        bonus = 5;
    }
    return x + bonus;
}

O variabilă declarată între { } există doar acolo. Declar-o înaintea blocului, ca să o poți folosi și după el.

3Cod vechi care folosește now

Greșit
SOLIDITY
uint256 public creat = now;
Corect
SOLIDITY
uint256 public creat = block.timestamp;

now a fost scos în Solidity 0.7. Numele corect este block.timestamp.

Repară tu

Repară eroarea, direct în pagină

Contractul Vanzari nu se compilează și dă DeclarationError: Undeclared identifier. O variabilă de stare e folosită cu alt nume decât cel declarat. Repară numele, fără să schimbi declarația. Scriptul înregistrează trei vânzări de câte 50, 20 și 30 de lei și afișează numărul de vânzări și totalul.

Codul care dă eroarea
SOLIDITY
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Vanzari {
    uint256 public numarVanzari;
    uint256 public totalLei;

    function inregistreaza(uint256 suma) external {
        numarvanzari += 1;
        totalLei += suma;
    }
}
După reparație, programul afișează
Vânzări: 3 | total: 100 lei
Indiciu

Compară literă cu literă numele din declarații cu cele din funcția inregistreaza.

Alte forme ale mesajului

  • DeclarationError: Undeclared identifier. Did you mean "totalVanzari"?
  • DeclarationError: Undeclared identifier. "f" is not (or not yet) visible at this point.

Cum o eviți pe viitor

  • Copiază numele variabilelor din declarație sau folosește completarea automată a editorului, în loc să le tastezi din nou.
  • Respectă o singură convenție: camelCase pentru variabile și funcții, PascalCase pentru contracte, evenimente și struct-uri.
  • Declară variabilele locale la nivelul la care le folosești (înaintea lui if / for, nu în interior).
  • Citește sugestia Did you mean ...? când apare: de obicei e chiar reparația.

Întrebări frecvente

Am declarat funcția, dar tot primesc Undeclared identifier. De ce?

Probabil e external și o apelezi din același contract. Funcțiile external se pot apela din interior doar prin this.f(), adică printr-un apel extern. Dacă vrei s-o apelezi și din contract, fă-o public sau mută logica într-o funcție internal.

Contează ordinea în care declar funcțiile și variabilele de stare?

Nu. Variabilele de stare și funcțiile sunt vizibile în tot contractul, oriunde ar fi declarate. Ordinea contează doar pentru variabilele locale, care există de la declarare până la finalul blocului lor.

Erori înrudite

← Toate erorile Solidity

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ță Solidity de la zero, cu exerciții la fiecare lecție

Curs Solidity și Smart Contracts: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.