TypeError: Data location must be "storage", "memory" or "calldata" for variable, but none was given.
O variabilă locală de tip struct, array sau string trebuie să spună dacă e o referință la datele contractului (storage) sau o copie temporară (memory). Dacă vrei să modifici datele salvate, scrie Produs storage p = produse[id]; dacă doar citești, memory.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În interiorul unei funcții, o variabilă locală de tip complex (struct, array, string, bytes) poate fi:
storage: o referință spre o variabilă de stare; orice modificare făcută prin ea se salvează pe blockchain;memory: o copie temporară; modificările dispar la finalul funcției;calldata: o referință la datele din tranzacție (doar pentru citire).
Compilatorul nu mai ghicește ce vrei, pentru că diferența e mare: cu memory, codul pare să funcționeze, dar nu salvează nimic. Aceasta este una dintre cele mai frecvente greșeli logice în Solidity: Produs memory p = produse[id]; p.stoc -= 1; compilează, dar stocul real nu scade.
Regula: dacă vrei să schimbi datele contractului prin variabila locală, storage. Dacă doar citești sau construiești o valoare nouă, memory.
De ce apare: cauzele frecvente
1Struct local fără locație
function vinde(uint256 id) external {
Produs p = produse[id];
p.stoc -= 1;
}function vinde(uint256 id) external {
Produs storage p = produse[id];
p.stoc -= 1;
}storage face din p o referință la produsul salvat, deci scăderea stocului rămâne permanentă.
2string local fără locație
string s = "salut";string memory s = "salut";Un text construit în funcție e o valoare temporară, deci memory.
3Ai pus memory unde voiai să modifici
Produs memory p = produse[id];
p.stoc -= 1; // compilează, dar nu salveazăProdus storage p = produse[id];
p.stoc -= 1;Nu e o eroare de compilare, dar e greșeala pe care mesajul încearcă să o prevină: memory lucrează pe o copie.
Repară eroarea, direct în pagină
Contractul Inventar nu se compilează și dă Data location must be "storage", "memory" or "calldata" for variable, but none was given. În vinde, variabila p trebuie să fie o referință la produsul salvat, ca vânzarea să scadă stocul real. Alege locația potrivită. Scriptul adaugă 10 caiete, vinde 3 și afișează stocul.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Inventar {
struct Produs {
string nume;
uint256 stoc;
}
mapping(uint256 => Produs) public produse;
function adauga(uint256 id, string calldata nume, uint256 stoc) external {
produse[id] = Produs(nume, stoc);
}
function vinde(uint256 id, uint256 bucati) external {
Produs p = produse[id];
require(p.stoc >= bucati, "Stoc insuficient");
p.stoc -= bucati;
}
}caiet | stoc: 7 Vând 20: Stoc insuficient
Indiciu
Vrei să modifici datele contractului prin p, nu o copie.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Inventar {
struct Produs {
string nume;
uint256 stoc;
}
mapping(uint256 => Produs) public produse;
function adauga(uint256 id, string calldata nume, uint256 stoc) external {
produse[id] = Produs(nume, stoc);
}
function vinde(uint256 id, uint256 bucati) external {
Produs storage p = produse[id];
require(p.stoc >= bucati, "Stoc insuficient");
p.stoc -= bucati;
}
}De ce merge
Fără locație, compilatorul nu știe dacă p e o copie sau o referință. Cu Produs storage p = produse[id];, p arată direct spre produsul din mapping, deci p.stoc -= bucati modifică stocul salvat pe blockchain și rămâne 7. Cu memory codul s-ar fi compilat, dar ar fi scăzut stocul unei copii, iar stocul real ar fi rămas 10.
Cum o eviți pe viitor
- Când iei un element dintr-un mapping sau array de struct-uri, întreabă-te: vreau să-l schimb? Atunci
storage. - Pentru valori noi, construite în funcție,
memory. - Testează mereu că modificarea chiar a rămas: citește valoarea din contract după tranzacție, nu doar în interiorul funcției.
Întrebări frecvente
storage e mai scump decât memory?
Depinde. O referință storage nu copiază nimic, deci e ieftină de creat, dar fiecare citire / scriere prin ea accesează storage-ul. memory copiază tot struct-ul la început. Pentru un struct mare din care citești un câmp, storage e de obicei mai ieftin.
Pot avea o variabilă storage nouă, neinițializată?
Nu. O variabilă locală storage trebuie să arate imediat spre ceva existent: Produs storage p = produse[id];. Pentru o valoare nouă folosește memory și apoi salveaz-o: produse[id] = p;.
Erori înrudite
TypeError: Data location must be "memory" or "calldata" for parameter in function, but none was given. Un parametru de tip string, bytes, array sau struct trebuie să spună unde stau datele. Adaugă memory sau calldata după tip: string memory nume (sau string calldata nume în funcțiile external, unde e mai ieftin). VM Exception while processing transaction: reverted with panic code 0x11 (Arithmetic operation underflowed or overflowed outside of an unchecked block) Un calcul a ieșit din limitele tipului: de obicei o scădere care ar da un număr negativ într-un uint (underflow), de exemplu sold -= suma când suma e mai mare decât soldul. Verifică înainte de calcul cu require(sold >= suma, "Sold insuficient"). Î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.
