Просто отсутствует определение функции.
void f(int); // всего лишь объявление. Нет `тела` функции
int main(){
f(42); // undefined reference to `f(int)'
}
Требуется добавить определение функции f
:
void f(int) {
// тело функции
}
Может быть ещё частный случай с ошибкой вида:
undefined reference to `vtable for <имя_класса>`
Такая ошибка возникает, если объявленная виртуальная функция класса, не являющаяся чистой (=0
), не содержит реализации.
class C {
virtual void f(int);
};
Нужно такую реализацию добавить. Если это делается вне класса, надо не забыть указать имя проблемного класса, иначе это будет просто свободная функция, которая не устраняет указанную проблему:
void C::f(int) { // виртуальная функция-член вне определения класса
// тело функции
}
void f(int) { // свободная функция, не устраняющая проблему
// тело функции
}
Аналогичная ситуация может возникать при использовании пространств имён, когда объявлении функции находится в пространстве имён:
// В заголовочном файле
namespace N {
void f(int);
};
а при реализации указать это пространство имён забыли:
// В файле реализации
void f(int) { // функция в глобальном пространстве имён, не устраняющая проблему
// тело функции
}
namespace N {
void f(int) { // функция в нужном пространстве имён
// тело функции
}
} // конец пространства имён
Стоит заметить, что C++ разрешает перегрузку функций (существование одноимённых функций, но с разным набором параметров), и в этом случае важно, чтобы сигнатуры функций при объявлении и определении совпадали. Например, вместо объявленной void f(int)
была реализована другая:
void f(const char*) { // const char* вместо int
// тело функции
}
При вызове f(42)
будет ошибка:
undefined reference to `f(int)'
Наличие связки шаблонного класса и дружественной функции также может приводить к ошибке. Например:
template <class T>
struct C {
friend void f(C<T>); // объявляет *НЕ*шаблонную дружественную функцию
};
template <class T> // определяет шаблонную функцию
void f(C<T>) { }
int main() {
C<int> c;
f(c); // undefined reference to `f(C<int>)'
}
Чтобы объявить шаблонную дружественную функцию, требуется добавить указание шаблонности:
template <class T>
struct C {
template <class V> // добавили шаблонность для friend функции
friend void f(C<T>);
};
Важно, что имя шаблонного параметра для дружественной функции должно отличаться от имени параметра шаблонного класса T
, т.к. иначе будет ошибка о сокрытии имени. В частном случае имя класса можно вовсе не указывать, и оставить template <class>
. Но это не всегда будет правильным решением, т.к. фактически могла потребоваться дружественная специализация шаблона функции, а не сама шаблонная функция. Подробнее об использовании дружественных функций в шаблонном классе можно ознакомиться здесь.
Неправильная реализация шаблонного кода.
Например, реализация шаблонного кода помещена в *.cpp
файл, хотя она должна находиться полностью в подключаемом *.h
файле. Это требуется по той причине, что компилятор обрабатывает каждый модуль независимо, и в момент инстанцирования шаблона (подстановки конкретного типа) код его реализации должен быть виден. При этом если возможные типы шаблона известны заранее, можно произвести инстанцирование сразу рядом с телом шаблона и не предоставлять его наружу в исходном коде заголовочного файла. Пример:
// unit.h
#pragma once
template <class T>
T f(T); // объявление шаблона без реализации
// unit.cpp
#include "unit.h"
template <class T>
T f(T t) { return t + t; } // реализация шаблона
template
int f<int>(int); // явное инстанцирование для int
template
double f<double>(double); // явное инстанцирование для double
// main.cpp
#include "unit.h"
int main() {
f(2); // ok int
f(1.5); // ok double
f('a'); // undefined reference to `char f<char>(char)'
}
Имя не имеет внешнего связывания.
Например, есть объявление функции f
в модуле А
и даже ее реализация в модуле B
, но реализация помечена как static
:
// A.cpp
void f();
int main() {
f(); // undefined reference to `f()'
}
// B.cpp
static void f() {}
Аналогичная ситуация может возникнуть при использовании безымянного пространства имен:
// B.cpp
namespace {
void f() {}
}
Или даже при наличии inline
у функции:
// B.cpp
inline void f() {}