Undefined reference to linker error when using namespaces in headers in c++

Question

I've read through all similar "Undefined reference to" threads I could find but couldn't find a solution. Most of the other threads also involved classes which I don't plan to use for this. The program compiles executes normally if I define the function within the header instead of using an external .cc file. I feel like I'm missing something simple here.

This is the simplest test I could put together that recreates the issue I'm having.

Compiler: g++ (Debian 8.3.0-6) 8.3.0

hntest.h

namespace hntest
{
    void pewpew();
}

hntest.cc

#include <iostream>
#include "hntest.h"

namespace hntest
{
    void pewpew()
    {
        std::cout << "pew pew pew!!!" << std::endl;
    }
}

hntestmain.cc

#include "hntest.h"

int main(int argc, char* argv[])
{
    hntest::pewpew();
}

I'm attempting to compile with:

g++ -lstdc++ hntestmain.cc -o hntestmain

And I get the following linker error:

hntestmain.cc:(.text+0x10): undefined reference to `hntest::pewpew()'
collect2: error: ld returned 1 exit status

I have tried reading through the code of a couple popular C++ libraries as well as some of my own older C (not ++) code and makefiles but haven't been able to find my error. I'm admittedly both and amateur an a bit rusty.

What am I missing?

Yes! "#3) Object Files Not Linked Properly The way to resolve this error is to compile both the files simultaneously (For example, by using g++)." — xgreenmanx, Apr 06 '21 at 05:13
The answer that is specific in that duplicate for you is: https://stackoverflow.com/a/12574400/1294207 — Fantastic Mr Fox, Apr 06 '21 at 05:19

Fantastic Mr Fox · Accepted Answer · 2021-04-06T05:24:54.790

2

You are not actually compiling the cpp file that has the definition of pewpew.

Try:

g++ -lstdc++ hntestmain.cc hntest.cc -o hntestmain

The compiler needs to know about all the source files. The header file is dealt with during pre-process and knows to look in the same folder. You can imagine that if you have more files, say 10, 100 or 10000, this would become impossible to manage by using command line. That is why people created build systems like make, cmake and bazel.

For much greater detail see the answer here which is specific for your case of linker error.

edited Apr 06 '21 at 05:24

answered Apr 06 '21 at 05:16

Fantastic Mr Fox

32,495
27
95
175

Ahh... rookie mistake on my part. Completely forgot I could just pass the definition file to the compiler along with main.cc. I've only used make for one project and that was a pretty extensive tutorial I followed. I really appreciate the responses and explanations. – xgreenmanx Apr 06 '21 at 05:25

Undefined reference to linker error when using namespaces in headers in c++

1 Answers1