...
← Curs Solidity și Smart Contracts: toate lecțiile
Lecția 9 · Funcții

Funcții view și pure

Nu orice funcție schimbă starea. Multe doar calculează sau citesc. Cu view și pure îi spui compilatorului (și aplicațiilor) că funcția nu modifică nimic, iar asta o face gratuită când o apelezi din afară.

Trei feluri de funcții

Gândește-te la o bibliotecă. Să împrumuți o carte schimbă registrul (funcție normală). Să te uiți în catalog doar citește registrul (view). Să calculezi cât costă o întârziere de 3 zile la 2 lei pe zi nu are nevoie de registru deloc (pure).

funcție normalăviewpurecitește storagedadanuscrie storagedanunuapel din afarătranzacțiecall gratuitcall gratuitexempluseteaza(t)inmultesteCuBaza(x)patrat(x)
Funcția normală poate citi și scrie storage-ul și se apelează prin tranzacție; view doar citește; pure nu atinge storage-ul deloc. Ultimele două sunt gratuite la apel din afară.
  • view: poate citi variabile de stare, msg.sender, block.timestamp, dar nu poate scrie nimic.
  • pure: nu poate nici citi, nici scrie starea; rezultatul depinde doar de parametri.
  • fără niciunul: funcție normală, care poate modifica starea.

Un exemplu cu amândouă

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Magazin {
    uint public tva = 19;

    // view: citește tva din storage
    function pretCuTva(uint pret) public view returns (uint) {
        return pret + pret * tva / 100;
    }

    // pure: lucrează doar cu parametrii
    function reducere(uint pret, uint procent) public pure returns (uint) {
        return pret - pret * procent / 100;
    }
}
const m = await deploy("Magazin");
console.log("1000 cu TVA:", await m.pretCuTva(1000));
console.log("1000 cu 25% reducere:", await m.reducere(1000, 25));

const inainte = await sold(ana);
for (let i = 0; i < 5; i++) await m.pretCuTva(500);
console.log("Sold neschimbat după 5 citiri:", (await sold(ana)) === inainte);
1000 cu TVA: 1190
1000 cu 25% reducere: 750
Sold neschimbat după 5 citiri: true

pretCuTva are nevoie de tva din storage, deci este view. reducere folosește doar parametrii, deci este pure. Cinci citiri nu au costat nimic: soldul Anei este exact același.

Gratuit doar din afară

Un apel view/pure făcut din JavaScript este un call: rulează pe un singur nod, fără tranzacție. Dacă însă o funcție normală apelează în interiorul ei o funcție view, instrucțiunile acelea consumă gas ca parte din tranzacție.

Compilatorul te verifică

Cuvintele view și pure nu sunt doar etichete: compilatorul verifică că le respecți. Dacă o funcție view încearcă să scrie, primești o eroare de compilare:

function seteaza(uint t) public view {
    temperatura = t; // eroare
}

Compilatorul oprește totul cu o eroare de tip pe linia atribuirii (în editor o vezi tradusă): Funcția este declarată view, dar această instrucțiune modifică starea. În engleză, mesajul original al lui solc începe cu Function cannot be declared as view. Iar dacă o funcție pure citește o variabilă de stare, eroarea (tradusă) spune: Funcția este declarată pure, dar citește starea contractului (sau msg / block). Folosește view în loc de pure.

Invers, dacă scrii o funcție normală care doar citește, compilatorul nu dă eroare, dar afișează un avertisment gri: funcția poate fi restricționată la view (sau pure). Ascultă-l: aplicațiile vor ști astfel că o pot apela gratuit.

Cum alegi

1
Funcția modifică o variabilă de stare, trimite ether sau emite un eveniment? Atunci este normală.
2
Doar citește variabile de stare, msg.sender sau block.timestamp? Atunci este view.
3
Folosește doar parametrii și valori constante? Atunci este pure.
FuncțieTip corectDe ce
numar() (getter)viewcitește numar din storage
aduna(a, b)puredoar parametrii
creste()normalăscrie numar
cineSunt()viewcitește msg.sender

Greșeli frecvente

  • **returns uitat**: o funcție view fără returns (...) nu întoarce nimic și nu are sens.
  • **pure pe o funcție care citește msg.sender**: eroare de compilare; msg.sender face parte din context, deci funcția e view.
  • „view înseamnă privat.” Nu: view spune doar că funcția nu modifică starea; vizibilitatea (public) este altă proprietate.
  • Ignorarea avertismentelor: o funcție care putea fi view va fi tratată de unele aplicații ca tranzacție, cu cost inutil.

Exemple reale

Cotații de preț

Uniswap are funcții view care calculează cât primești la un schimb, apelate gratuit de interfață la fiecare tastă.

Biblioteci de calcul

Funcțiile matematice (procente, dobânzi) sunt de obicei pure.

balanceOf

Soldul unui token este o funcție view: portofelele o apelează constant, fără cost.

Exercițiul tău

Scrie contractul Calculator cu variabila publică baza (uint) egală cu 10, funcția inmultesteCuBaza(uint x) de tip view, care returnează x * baza, și funcția patrat(uint x) de tip pure, care returnează x * x. Scriptul lecției afișează rezultatele pentru 7.

  • Declară uint public baza = 10;.
  • Scrie inmultesteCuBaza(uint x) ca public view returns (uint).
  • Scrie patrat(uint x) ca public pure returns (uint).
inmultesteCuBaza citește baza, deci e view; patrat folosește doar x, deci e pure.

Soluția exercițiului

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Calculator {
    uint public baza = 10;

    function inmultesteCuBaza(uint x) public view returns (uint) {
        return x * baza;
    }

    function patrat(uint x) public pure returns (uint) {
        return x * x;
    }
}
Excelent! Continuă cu lecția următoare →
Contract.solSolidity
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași cu smart contracts Lecția 9 · Funcții view și pure
Progres 0% 0 din 17
Lecția curentă 9 / 15 Funcții