This question already has answers here:
Closed 12 years ago.
Possible Duplicate:
Why can templates only be implemented in the header file??
Hi,
I have a c++ project which consists of several header and source files. In order to modify the class with a template, I found that all the method definitions must be included in the header file itself, else resulting in a link-time error. What is the reason for this and how can I get over this ??
Thank You!!
This is intentional. Templates go in header files, end of story. There is no way around it. In order for the compiler to instantiate the template it must be able to see it, which means it must be in a header file. Templates are not like C# generics, where the model allows them to be hidden an essentially instantiated by the linker - templates are much more complicated than that, so they have to live in header files.
In your travels you will find mention of the export keyword, which was supposed to solve this. To cut a long story short, it didn't, no one implemented it (apart from one very brave compiler vendor) and it will soon not be part of C++ any more.
Related
This question already has answers here:
What should go into an .h file?
(12 answers)
Closed 2 years ago.
I have searched almost every website I could, but nobody has been able to answer my question. Basically what I ask, is what exactly should I place in a header file? I know of function declarations, but are variable declarations in a .h file also a thing? I need to know what the "tradition" or the "usual method" is of usage of header files.
EDIT : If this helps, I just recently started C++ and my objective with learning this language is an opportunity to get into the industry, mainly gamedev, and I need to know what the proper way of doing stuff is. Hence the question.
Header files conventionally contain declarations of entities that you wish to share between translation units.
That usually means class definitions, type aliases, and function declarations.
A translation unit, very roughly speaking, is "a .cpp file".
So, if you use a function in a.cpp, and you also use it in b.cpp, a declaration for it needs to be available in both translation units, and the best way to do that is to write it once in a header file, then include the header file in both .cpp files.
That's it.
While it's possible to declare variables in a header file, it's rare to do so. For starters, you'd want to put extern on it to make it not a definition (you don't want multiple definitions!). At that point, you have to ask yourself why you're not using a class.
This question already has answers here:
How to make closed source for the library written with template in C++
(3 answers)
Closed 6 years ago.
C++ Compiler needs to have access to the implementation of the methods in order to instantiate a template class. Hence we need to either include the definitions of a template in the header file that declares that template or define them in header files. But I want to hide the implementation (definitions) of my functions from my users due to many reasons and want to ensure that they have only access to the function declarations. Is it possible to do so while using templates in C++?
This is usually done (for eg) in boost by creating a directory hierarchy impl and detail.
impl will usually have the implementatios for the exposed API member function while inside the detail as you might have guessed, has the gritty details which you do not want to expose. This system is fairly well understood by the C++ developers.
As an example:
my_service.hpp
impl/my_service.hpp
impl/my_service.ipp ( OR )
detail/my_service.ipp
So, the idea is to split the header files and provide the users to only include your top level header file which will internally include the other files.
But nobody is stopping the users to include the impl header file as well directly. If you want to avoid that too, then you can do something on the lines of Prevent header from being included in some files, in compilation time?
This question already has answers here:
Why have header files and .cpp files? [closed]
(9 answers)
Closed 6 years ago.
Comming from a mostly Java background I recently started learning a bit of C++.
I'm trying to create a class that describes a LinkedList. Since I want this class to be something like an external library, so I can use it in other applications, I need it to be declared as a header file.
I understand that from a design point of view C++ needs both a header and a cpp file, where the header will mostly contain declarations and the implementation will be left for the cpp file.
What I don't understand though is what is the actual purpose of the above design technique. The point of being able to quickly go through the header file and read the comments about the functionality of each method seems moot to me, since C++ (or at least my Codeblocks editor) supports the
/** comments like Java so it is much easier to create an object of the class and simply hit the . button to open the methods description menu, and read any description I like in a more orderly and structured manner than going through a header file.
Also I noticed that the program runs fine if put everything inside the header file and completly ignore the cpp file.
So my question boils down to whether I should just implement everything in the header file, or whether this is considered unacceptable C++ coding practice and if so, why.
Headers contain the bare minimum required to be able to use the functionality, since they get to some intermediate preprocessed file. The smaller that file, the easier to compile that unit.
They have to contain structure definitions and function declaration in this sense. This is unlike Java which doesn't require prior declaration in order to use and is a historical artifact which cannot be fixed now. The #include lines really paste the text in the header within the actual C/CPP file (sort of -- the preprocessing, conditional compilation etc have to happen in the headers too)
This question already has answers here:
Why have header files and .cpp files? [closed]
(9 answers)
Closed 8 years ago.
I understand the header file contains all the prototypes of every function contained in the implementation file; but what is the real purpose? Is it because when another program calls on the class, it only receives the information in the header file, and the implementation is kept hidden? What is the real purposes of this?
The purpose is that when someone gives you a library, they don't always give you the code. And frankly you don't want to know about it. You simply need to know the function prototypes and data structures it provides, which you obtain from the Header File. And then you link to the library.
Here's an example that might help make some sense of it for you:
I publish a library libfoo (doesn't matter if its a .so, .a or .dll) and told you it had a bunch of good functions and data type in it that solve a problem and you want to use it. If I didn't give you the header file, how would your code possibly compile when it would need to know how big data structures are / what function signatures to look for? How would you know how to code it?
The library won't be referenced until linking, and compilation is already complete at that point in time.
I'm having a problem with linking the objects of one of my C++ applications. The source files are all compiled into object files, but many of them rely on the same library, which has a fully specialised function template. The linker complains when trying to link them all together. I understand why this is, but I don't understand how to fix it.
I found this, which explains the problem exactly, but the forum thread never got to a point where the OP asked for a solution. Womp, womp.
How do I compile all the source files, but only get the specialised functions from the library once?
The problem there is that the specialization also has the implementation in the header, which is wrong.
You should either move the implementation to a source file, or mark the method as inline.