All 11 Compilation & Linking questions
More in Compilation & Linking
What are the stages of building a C++ program? What is a translation unit? What is the difference between compile-time and link-time errors? What is the difference between declaration and definition? What is the One Definition Rule (ODR)? What is name mangling? Why do you need include guards or #pragma once, in linkage terms? What is internal versus external linkage? What is the difference between static and dynamic (shared) libraries? What are C++20 modules and how do they improve on headers?
Advertisement
C++ › Compilation & Linking

What causes an 'undefined reference' (unresolved symbol) linker error?

Beginner

Answer

It means a symbol was declared and used but the linker couldn't find its definition: a missing source file/object, a library not linked, a function declared but never defined, a signature mismatch (name mangling differs), or forgetting extern "C" for C functions. The fix is to provide/link the definition or correct the declaration.
// declared void f(); used f(); but f never defined -> undefined reference
Real-world example Forgetting to link the math library or a .cpp file yields an 'undefined reference' at link time.

Common follow-ups: What are common causes? | Is it a compiler or linker error?

Compilation & Linking Namespaces Compilation & Linking
All 11 Compilation & Linking questions