...
Eroare C++ · Funcții, apeluri și linker

undefined reference to `calculeazaTotal(int)'

Pe scurt

Eroare de linker: funcția a fost declarată (are prototip), deci codul compilează, dar nicăieri nu există corpul ei. Scrie definiția funcției, cu exact aceeași semnătură ca prototipul, sau adaugă fișierul .cpp în care se află.

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

Ce înseamnă

Construirea unui program C++ are două etape: compilarea (fiecare fișier .cpp e verificat și transformat în cod mașină) și linkarea (bucățile sunt legate între ele). Un prototip ca int calculeazaTotal(int n); îi spune compilatorului că funcția există undeva, deci apelul trece de prima etapă.

La linkare, linker-ul caută codul funcției și nu îl găsește: mesajul este undefined reference to 'calculeazaTotal(int)' (GCC/ld pe Linux), Undefined symbols for architecture arm64 pe Mac, undefined symbol: calculeazaTotal(int) cu wasm-ld, urmat de linker command failed with exit code 1. Nu are număr de linie, pentru că problema nu e într-o linie anume.

Cauzele: lipsește definiția, definiția are altă semnătură (alt tip de parametru, const lipsă, altă majusculă), o metodă de clasă e definită fără NumeClasa::, sau fișierul cu definiția nu este compilat împreună cu restul.

De ce apare: cauzele frecvente

1Prototip fără definiție

Greșit
C++
int calculeazaTotal(int n);

int main() {
    cout << calculeazaTotal(3);
}
Corect
C++
int calculeazaTotal(int n);

int main() {
    cout << calculeazaTotal(3);
}

int calculeazaTotal(int n) {
    return n * 10;
}

Prototipul promite funcția, iar definiția o furnizează. Fără ea, linker-ul nu are ce lega.

2Semnătură diferită la definiție

Greșit
C++
double medie(int a, int b);

double medie(double a, double b) {
    return (a + b) / 2;
}
Corect
C++
double medie(int a, int b);

double medie(int a, int b) {
    return (a + b) / 2.0;
}

Cu alte tipuri de parametri, definiția este altă funcție (o supraîncărcare). medie(int, int) rămâne nedefinită.

3Metodă definită fără numele clasei

Greșit
C++
class Cont {
public:
    void depune(int suma);
};

void depune(int suma) { }
Corect
C++
class Cont {
public:
    void depune(int suma);
};

void Cont::depune(int suma) { }

Fără Cont::, ai definit o funcție liberă, nu metoda clasei. Linker-ul caută Cont::depune(int).

Repară tu

Repară eroarea, direct în pagină

Programul calculează totalul unei comenzi de cafele, dar build-ul se oprește la linkare cu undefined reference to 'calculeazaTotal(int)' (pe Mac: Undefined symbols). Scrie definiția funcției sub main: o cafea costă 12 lei. Programul trebuie să afișeze Total pentru 3 cafele: 36 lei.

Codul care dă eroarea
C++
#include <iostream>
using namespace std;

int calculeazaTotal(int cafele);

int main() {
    int cafele = 3;
    cout << "Total pentru " << cafele << " cafele: " << calculeazaTotal(cafele) << " lei\n";
    return 0;
}
După reparație, programul afișează
Total pentru 3 cafele: 36 lei
Indiciu

Prototipul există; lipsește corpul funcției, cu aceeași semnătură.

Alte forme ale mesajului

  • Undefined symbols for architecture arm64: "calculeazaTotal(int)", referenced from:
  • wasm-ld: error: undefined symbol: calculeazaTotal(int)
  • clang++: error: linker command failed with exit code 1 (use -v to see invocation)
  • undefined reference to `Cont::depune(int)'

Cum o eviți pe viitor

  • Când scrii un prototip, scrie imediat și o definiție (chiar și goală) pentru funcție.
  • Copiază semnătura din prototip în definiție, ca tipurile să fie identice.
  • Pentru metode definite în afara clasei, nu uita prefixul NumeClasa::.
  • În proiecte cu mai multe fișiere, verifică că toate fișierele .cpp sunt incluse în compilare.

Întrebări frecvente

De ce eroarea nu are număr de linie?

Pentru că vine de la linker, nu de la compilator. Linker-ul lucrează cu cod deja compilat, unde nu mai există linii de sursă, ci doar nume de funcții. Mesajul îți dă numele funcției care lipsește; caut-o în cod.

Care e diferența față de use of undeclared identifier?

use of undeclared identifier apare la compilare, când funcția nu este nici măcar declarată. undefined reference apare la linkare: funcția este declarată, dar nu are corp.

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.