72

I'm setting up a C++ project, on Ubuntu x64, using Eclipse-CDT. I'm basically doing a hello world and linking to a commerical 3rd party library.

I've included the header files, linked to their libraries, but I still get linker errors. Are there some possible problems here other than the obvious (e.g. I am 99% sure I'm linking to the correct library).

  1. Is there a way to confirm the static libraries I am linking to are 64bit?
  2. Is there a way to confirm that the library has the class (and methods) I am expecting it to have?

Eclipse says:

Building target: LinkProblem
Invoking: GCC C++ Linker
g++ -L/home/notroot/workspace/somelib-3/somelib/target/bin -o"LinkProblem"  ./src/LinkProblem.o   -lsomelib1 -lpthread -lsomelib2 -lsomelib3
./src/LinkProblem.o: In function `main':
/home/notroot/workspace/LinkProblem/Debug/../src/LinkProblem.cpp:17: undefined reference to `SomeClass::close()'
./src/LinkProblem.o: In function `SomeOtherClass':
/home/notroot/workspace/somelib-3/somelib/include/sql/somefile.h:148: undefined reference to `SomeClass::SomeClass()'
/home/notroot/workspace/somelib-3/somelib/include/sql/somefile.h:148: undefined reference to `vtable for SomeOtherClass'
/home/notroot/workspace/somelib-3/somelib/include/sql/somefile.h:151: undefined reference to `SomeClass::~SomeClass()'
./src/LinkProblem.o: In function `~SomeOtherClass':
/home/notroot/workspace/somelib-3/somelib/include/sql/somefile.h:140: undefined reference to `vtable for SomeOtherClass'
/home/notroot/workspace/somelib-3/somelib/include/sql/somefile.h:140: undefined reference to `SomeClass::~SomeClass()'
/home/notroot/workspace/somelib-3/somelib/include/sql/somefile.h:140: undefined reference to `SomeClass::~SomeClass()'
collect2: ld returned 1 exit status
make: *** [LinkProblem] Error 1
9
  • Is the 3rd party library 64-bit? Jul 7, 2009 at 23:06
  • Yes, it is 64bit. You could be on to something though. How do I ensure my code/project is 64bit? In Visual Studio I created a x64 build config. Jul 7, 2009 at 23:07
  • 1
    Is there a way to confirm the 3rd party library is 64bit? E.g. inspect the .a files with a tool or something? Jul 7, 2009 at 23:08
  • Where is it located? A google shows that there is a semi-convention having it in the /usr/lib64 Jul 7, 2009 at 23:11
  • The third party lib files are here: /home/notroot/workspace/somelib-3/somelib/target/bin Jul 7, 2009 at 23:13

12 Answers 12

168

This linker error usually (in my experience) means that you've overridden a virtual function in a child class with a declaration, but haven't given a definition for the method. For example:

class Base
{
    virtual void f() = 0;
}
class Derived : public Base
{
    void f();
}

But you haven't given the definition of f. When you use the class, you get the linker error. Much like a normal linker error, it's because the compiler knew what you were talking about, but the linker couldn't find the definition. It's just got a very difficult to understand message.

4
  • 4
    Thank You. I couldn't find a solution for 2 hours. Nov 24, 2010 at 16:13
  • 2
    Exactly the problem I was having. Thanks you saved my time and effort.
    – Haider
    Aug 28, 2012 at 10:19
  • Interesting that in my case it happens with 'pure virtuals' only! The error message is really misleading.
    – mishmashru
    Apr 24, 2013 at 17:14
  • This was my problem. Forgot to set it to 0!
    – scottc
    Aug 23, 2015 at 20:13
74

Assuming those methods are in one of the libs it looks like an ordering problem.

When linking libraries into an executable they are done in the order they are declared.
Also the linker will only take the methods/functions required to resolve currently outstanding dependencies. If a subsequent library then uses methods/functions that were not originally required by the objects you will have missing dependencies.

How it works:

  • Take all the object files and combine them into an executable
  • Resolve any dependencies among object files.
  • For-each library in order:
    • Check unresolved dependencies and see if the lib resolves them.
    • If so load required part into the executable.

Example:

Objects requires:

  • Open
  • Close
  • BatchRead
  • BatchWrite

Lib 1 provides:

  • Open
  • Close
  • read
  • write

Lib 2 provides

  • BatchRead (but uses lib1:read)
  • BatchWrite (but uses lib1:write)

If linked like this:

gcc -o plop plop.o -l1 -l2

Then the linker will fail to resolve the read and write symbols.

But if I link the application like this:

gcc -o plop plop.o -l2 -l1

Then it will link correctly. As l2 resolves the BatchRead and BatchWrite dependencies but also adds two new ones (read and write). When we link with l1 next all four dependencies are resolved.

16
  • Are you referring to the order of the lib files on the G++ command line? Jul 7, 2009 at 23:14
  • Yes. :-) Jul 7, 2009 at 23:20
  • I notice your example uses "gcc" whereas my question uses "g++", should I use "gcc" instead? Jul 7, 2009 at 23:21
  • 2
    No use what you were using.If your code contains C++ stuff you will need to use g++ to get the correct standard libraries. Jul 7, 2009 at 23:25
  • 3
    this really helped me! My groupproject suddenly stopped accepting new cpp files from one of my libs, it was all about undefined reference, then I switched positions and it worked as a charm. Seriously, there should be a more specific article on some pages out there about this issue. Thanks a lot Martin!
    – Jonathan
    May 24, 2010 at 1:49
53

Qt C++ will show this error when you change a class such that it now inherits from QObject (ie so that it can now use signals/slots). Running qmake -r will call moc and fix this problem.

If you are working with others via some sort of version control, you will want to make some change to your .pro file (ie add/remove a blank line). When everyone else gets your changes and runs make, make will see that the .pro file has changed and automatically run qmake. This will save your teammates from repeating your frustration.

3
  • Thanks ! Very hard to find without clues! May 15, 2012 at 13:12
  • 1
    Also, if you forget to add the class to the *.pro file's HEADER's section you'll get the same error. The class's header must be HEADER for moc to pick up Q_OBJECT.
    – vpicaver
    Jun 20, 2016 at 12:51
  • Thank you for hint! I build lib but without MOC stuff... Q_OBJECT ....
    – Gelldur
    Jan 27 at 14:58
14

The problem for me turned out to be pretty obscure. My class looked like this:

//-----------------------------------------
// libbase.h
class base {
public:
   base() { }
   virtual ~base() { }

   virtual int foo() { return 0; }
};
//-----------------------------------------

//-----------------------------------------
// libbase.cpp
#include "libbase.h"
//-----------------------------------------

//-----------------------------------------
// main.h
class derived : public base {
public:
    virtual int foo() ;
};
//-----------------------------------------

//-----------------------------------------
// main.cpp
int main () {
    derived d;
}
//-----------------------------------------

The problem is in the linker. My header file went in a library somewhere, but all the virtual functions were declared 'inline' in the class declaration. Since there was no code using the virtual functions (yet), the compiler or linker neglected to put actual function bodies in place. It also failed to create the vtable.

In my main code where I derived from this class, the linker tried to connect my class to the base class and his vtable. But the vtable had been discarded.

The solution was to declare at least one of the virtual functions' bodies outside the class declaration, like this:

//-----------------------------------------
// libbase.h
class base {
public:
   base() { }
   virtual ~base() ;   //-- No longer declared 'inline'

   virtual int foo() { return 0; }
};
//-----------------------------------------

//-----------------------------------------
// libbase.cpp
#include "libbase.h"
base::~base() 
{
}
//-----------------------------------------
2
  • for me it was the subclass and its virtual function Jan 19, 2015 at 15:22
  • You miss semicolon in the end of class definition :)
    – Justme0
    Jul 15, 2018 at 15:50
9

In regards to problems with Qt4, I couldn't use the qmake moc option mentioned above. But that wasn't the problem anyway. I had the following code in the class definition:

class ScreenWidget : public QGLWidget
{
   Q_OBJECT        // must include this if you use Qt signals/slots
...
};

I had to remove the line "Q_OBJECT" because I had no signals or slots defined.

1
  • Thanks! Had this problem using g++ and cmake, with code that compiled fine in studio. Sep 30, 2014 at 18:06
8

I had this error message. The problem was that I declared a virtual destructor in the header file, but the virtual functions' body was actually not implemented.

5

This error will also occur when we simply declare a virtual function without any definition in the base class.

For example:

class Base
{
    virtual void method1(); // throws undefined reference error.

}

Change the above declaration to the below one, it will work fine.

class Base
{
    virtual void method1()
    {
    }
}
2
  • This really worked for me! Can you explain why ths happens? I have seen many classes where a virtual function is declared without curly braces.
    – kunal18
    Jun 8, 2015 at 16:28
  • @stalin if you declare if without curly braces, that means you're going to implement it somewhere else (usually in the .cpp file).
    – Ven
    Nov 16, 2015 at 17:05
4

In my case the problem occured when i forgot to add the =0 on one function in my pure virtual class. It was fixed when the =0 was added. The same as for Frank above.

class ISettings
{
public: 
    virtual ~ISettings() {};
    virtual void OKFunction() =0;
    virtual void ProblemFunction(); // missing =0   
};

class Settings : ISettings
{
    virtual ~Settings() {};
    void OKFunction();
    void ProblemFunction(); 
};

void Settings::OKFunction()
{
    //stuff
}

void Settings::ProblemFunction()
{
    //stuff
}
1

I stumbled across the issue now, too. The application defined a pure virtual interface class and a user-defined class provided through a shared lib was supposed to implement the interface. When linking the application, the linker complained that the shared lib would not provide vtable and type_info for the base class, nor could they be found anywhere else. Turned out that I simply forgot to make one of the interface's methods pure virtual (i.e. omitted the " = 0" at the end of the declaration. Very rudimentary, still easy to overlook and puzzling if you can't connect the linker diagnostic to the root cause.

0

I had this error message when trying "hello world" like things with Qt. The problems went away by correctly running the qt moc (meta object compiler) and compiling+including these moc-generated files correctly.

0

If you have a base class with pure virtual function, make sure your base class constructor and destructor has body otherwise linker fails.

1
  • It actually has nothing to do with the constructor or destructor. Not having those will give you a general linker fail. You have to be missing a virtual method to get a linker error on the vtable.
    – Mysticial
    Mar 24, 2014 at 17:42
0

I put this for future visitors:

if you are receiving the error on creating an Exception object, then the cause of it probably is a lack of definition for what() virtual function.

Not the answer you're looking for? Browse other questions tagged or ask your own question.