Purpose of Header guards

by

The guard header (or more conventionally “include guard”) is to prevent problems if header file is included more than once; e.g.

#ifndef MARKER
#define MARKER
// declarations 
#endif

The first time this file is #include-ed, the MARKER preprocessor symbol will be undefined, so the preprocessor will define the symbol, and the following declarations will included in the source code seen by the compiler. On subsequent #include‘s, the MARKER symbol will be defined, and hence everything within the #ifnde / #endif will be removed by the preprocessor.

For this to work properly, the MARKER symbol needs to be different for each header file that might possibly be #include-ed.

The reason this kind of thing is necessary is that it is illegal in C / C++ to define a type or function with the same name more than once in a compilation unit. The guard allows you to #include a header file without worrying if has already been included. Without the guard, multiple inclusions of the same header file would lead to unwanted redeclarations and compilation errors. This is particularly helpful when header files need to #include other header files.

In short, it doesn’t prevent you from #include-ing a file again and again. Rather, it allows you to do this without causing compilation errors.

More Related Contents:

  1. Why aren’t my include guards preventing recursive inclusion and multiple symbol definitions?
  2. Is #pragma once a safe include guard?
  3. C++ #include guards
  4. Header guards in C++ and C
  5. in C++ , what’s so special about “_MOVE_H”?
  6. Why isn’t C/C++’s “#pragma once” an ISO standard?
  7. Naming Include Guards
  8. How are copy constructors used and why are they important? [closed]
  9. Dots in printf in C++
  10. How can I use std::maps with user-defined types as key?
  11. Difference in make_shared and normal shared_ptr in C++
  12. Combining C++ and C – how does #ifdef __cplusplus work?
  13. Forward declaring an enum in C++
  14. What is the idea behind ^= 32, that converts lowercase letters to upper and vice versa?
  15. What does auto&& tell us?
  16. How to find if a given key exists in a C++ std::map
  17. Using SDL2 with CMake
  18. How are C++ array members handled in copy control functions?
  19. What is going on with ‘gets(stdin)’ on the site coderbyte?
  20. Simple glob in C++ on unix system?
  21. Formatting output in C++
  22. Can C++ have code in the global scope?
  23. constructor invocation mechanism
  24. Finding out the CPU clock frequency (per core, per processor)
  25. Dynamic aligned memory allocation in C++11
  26. Why does this call the default constructor?
  27. std::vector reserve() and push_back() is faster than resize() and array index, why?
  28. std::unique_ptr with derived class
  29. version `CXXABI_1.3.8′ not found (required by …) [duplicate]
  30. How to count clock cycles with RDTSC in GCC x86? [duplicate]

Leave a Comment