94

Because I've made .cpp files and then transferred them into .h files, the only difference I can find is that you can't #include .cpp files. Is there any difference that I am missing?

3
  • 4
    To understand people's answers below, you might need to ask another question: i.e. "What's the difference between a 'declaration' and a 'definition' in C++?"
    – ChrisW
    Commented May 17, 2009 at 21:00
  • 1
    I know the difference between a declaration and a definition.
    – user98188
    Commented May 17, 2009 at 21:23
  • 3
    You can include anything you want, but linking stage will break if you include global variables into more than one compilation units. That's why there is a convention to not link .cpp files.
    – John Smith
    Commented May 17, 2009 at 22:16

8 Answers 8

89

The C++ build system (compiler) knows no difference, so it's all one of conventions.

The convention is that .h files are declarations, and .cpp files are definitions.

That's why .h files are #included -- we include the declarations.

4
  • 1
    The C++ build system does differentiate - try running g++ on a .h file and a .cpp file and see what happens, for example.
    – anon
    Commented May 17, 2009 at 21:09
  • 1
    I know that .cpp files are used (most of the time) to define functions/classes/etc that have been declared in .h files, but you can define variables in .h files too.
    – user98188
    Commented May 17, 2009 at 21:25
  • 5
    @Neil Butterworth: Yes the G++ compiler understands the convention, but you can make it compile by forcing the language. Commented May 18, 2009 at 15:03
  • 1
    This is like saying "Windows knows no difference between a .png and a .doc". At some level, they’re both just files and Windows doesn’t know the difference. But Windows is configured to treat them differently. Many C++ build systems are configured to know the difference. For example, by default Visual Studio puts .cpp files in <ClCompile /> tags in its vcxproj files, but header files included in the same project are in <ClInclude /> tags. XCode won’t list .h files under “Compile Sources” in its “Build Phases” tab, but it will list .c, .cpp, .m and .mm files there.
    – bobobobo
    Commented Sep 29, 2021 at 0:02
42

.h files, or header files, are used to list the publicly accessible instance variables and methods in the class declaration. .cpp files, or implementation files, are used to actually implement those methods and use those instance variables.

The reason they are separate is because .h files aren't compiled into binary code while .cpp files are. Take a library, for example. Say you are the author and you don't want it to be open source. So you distribute the compiled binary library and the header files to your customers. That allows them to easily see all the information about your library's classes they can use without being able to see how you implemented those methods. They are more for the people using your code rather than the compiler. As was said before: it's the convention.

1
  • 7
    i know he didn’t ask why but this is the most helpful answer for me. understanding the why makes it easier to connect the logic to the details
    – vampiire
    Commented Apr 17, 2020 at 22:22
37

The .cpp file is the compilation unit: it's the real source code file that will be compiled (in C++).

The .h (header) files are files that will be virtually copied/pasted in the .cpp files where the #include precompiler instruction appears. Once the headers code is inserted in the .cpp code, the compilation of the .cpp can start.

4
  • 1
    Why do you say THE .cpp file and not A .cpp file?
    – user98188
    Commented May 17, 2009 at 21:26
  • 12
    @Keand64: Because the compiler looks at only one .cpp file at a time when compiling things. It reads a .cpp file, reads all the #included .h files, compiles the whole thing, writes a .o (or .obj) file, and then proceeds to the next .cpp file. Commented May 17, 2009 at 21:50
  • Does this mean that .cpp and .h must have the same name? Commented Feb 28, 2020 at 15:33
  • @fathergorry No, there is no rule for naming source files (headers or not), only conventions.
    – Klaim
    Commented Mar 9, 2020 at 17:11
26

A header (.h, .hpp, ...) file contains

  • Class definitions ( class X { ... }; )
  • Inline function definitions ( inline int get_cpus() { ... } )
  • Function declarations ( void help(); )
  • Object declarations ( extern int debug_enabled; )

A source file (.c, .cpp, .cxx) contains

  • Function definitions ( void help() { ... } or void X::f() { ... } )
  • Object definitions ( int debug_enabled = 1; )

However, the convention that headers are named with a .h suffix and source files are named with a .cpp suffix is not really required. One can always tell a good compiler how to treat some file, irrespective of its file-name suffix ( -x <file-type> for gcc. Like -x c++ ).

Source files will contain definitions that must be present only once in the whole program. So if you include a source file somewhere and then link the result of compilation of that file and then the one of the source file itself together, then of course you will get linker errors, because you have those definitions now appear twice: Once in the included source file, and then in the file that included it. That's why you had problems with including the .cpp file.

1
  • As you have correctly mentioned, it's a header file that contains a class definition, not a source file. Commented Jun 24, 2022 at 14:32
13

I know the difference between a declaration and a definition.

Whereas:

  • A CPP file includes the definitions from any header which it includes (because CPP and header file together become a single 'translation unit')
  • A header file might be included by more than one CPP file
  • The linker typically won't like anything defined in more than one CPP file

Therefore any definitions in a header file should be inline or static. Header files also contain declarations which are used by more than one CPP file.

Definitions that are neither static nor inline are placed in CPP files. Also, any declarations that are only needed within one CPP file are often placed within that CPP file itself, nstead of in any (sharable) header file.

5

A good rule of thumb is ".h files should have declarations [potentially] used by multiple source files, but no code that gets run."

1
  • So I guess .h are akin to C# interfaces Commented Mar 25, 2020 at 11:39
3

By convention, .h files are included by other files, and never compiled directly by themselves. .cpp files are - again, by convention - the roots of the compilation process; they include .h files directly or indirectly, but generally not .cpp files.

3

Others have already offered good explanations, but I thought I should clarify the differences between the various extensions:

  Source Files for C: .c
  Header Files for C: .h

  Source Files for C++: .cpp
  Header Files for C++: .hpp

Of course, as it has already been pointed out, these are just conventions. The compiler doesn't actually pay any attention to them - it's purely for the benefit of the coder.

2
  • 8
    Most people actually use .h for C++ too.
    – Zifre
    Commented May 17, 2009 at 21:35
  • @Zifre: Yes, hence my saying that these are recommended naming conventions, even though many may not follow them.
    – Noldorin
    Commented May 17, 2009 at 22:05