Is it a good practice to define C++ functions inside header files? [duplicate]

by

If you want to use a function in multiple source files (or rather, translation units), then you place a function declaration (i.e. a function prototype) in the header file, and the definition in one source file.

Then when you build, you first compile the source files to object files, and then you link the object files into the final executable.

Example code:

  • Header file

      #ifndef FUNCTIONS_H_INCLUDED
  #define FUNCTIONS_H_INCLUDED

  int add(int a, int b);  // Function prototype, its declaration

  #endif

  • First source file

      #include "functions.h"

  // Function definition
  int add(int a, int b)
  {
      return a + b;
  }

  • Second source file

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

  int main()
  {
      std::cout << "add(1, 2) = " << add(1, 2) << '\n';
  }

How you build it depends very much on your environment. If you are using an IDE (like Visual Studio, Eclipse, Xcode etc.) then you put all files into the project in the correct places.

If you are building from the command line in, for example, Linux or OSX, then you do:

$ g++ -c file1.cpp
$ g++ -c file2.cpp
$ g++ file1.o file2.o -o my_program

The flag -c tells the compiler to generate an object file, and name it the same as the source file but with a .o suffix. The last command links the two object files together to form the final executable, and names it my_program (that’s what the -o option does, tells the name of the output file).

More Related Contents:

  1. New to programming: How to call a structure’s variables in a function and then update them? (C++) [closed]
  2. Compilation error: expected constructor, destructor, or type conversion before ‘;’ token [closed]
  3. Return array in a function
  4. Using generic std::function objects with member functions in one class
  5. What should go into an .h file?
  6. C++ callback using class member
  7. C++ return array from function [duplicate]
  8. Why doesn’t C++ support functions returning arrays?
  9. multiple definition in header file
  10. Should I use an exception specifier in C++?
  11. Why can’t we pass arrays to function by value?
  12. Inline function linkage
  13. Returning a pointer of a local variable C++
  14. C++ inline member function in .cpp file
  15. List of standard header files in C and C++
  16. C++: Argument Passing “passed by reference”
  17. .c vs .cc vs. .cpp vs .hpp vs .h vs .cxx [duplicate]
  18. Do class functions/variables have to be declared before being used?
  19. scope of using declaration within a namespace
  20. how do I make a portable isnan/isinf function
  21. Function in C++ returns by value or by reference?
  22. Function to mangle/demangle functions
  23. How much overhead is there in calling a function in C++?
  24. is it possible to make function that will accept multiple data types for given argument?
  25. Get signatures of exported functions in a DLL
  26. Eclipse CDT: Unresolved inclusion of stl header
  27. Template type deduction in C++ for Class vs Function?
  28. non-const pointer argument to a const double pointer parameter
  29. Can I get polymorphic behavior without using virtual functions?
  30. Why is there no multiple definition error when you define a class in a header file?

Leave a Comment