Forward declaration & circular dependency

by

A proper forward declaration is simply:

class Level;

Note the lack of curly braces. This tells the compiler that there’s a class named Level, but nothing about the contents of it. You can then use pointers (Level *) and references (Level &) to this undefined class freely.

Note that you cannot directly instantiate Level since the compiler needs to know the class’s size to create variables.

class Level;

class Entity
{
    Level &level;  // legal
    Level level;   // illegal
};

To be able to use Level in Entity‘s methods, you should ideally define Level‘s methods in a separate .cpp file and only declare them in the header. Separating declarations from definitions is a C++ best practice.

// entity.h

class Level;

class Entity
{
    void changeLevel(Level &);
};


// entity.cpp

#include "level.h"
#include "entity.h"

void Entity::changeLevel(Level &level)
{
    level.loadEntity(*this);
}

More Related Contents:

  1. Resolve build errors due to circular dependency amongst classes
  2. What are forward declarations in C++?
  3. Meaning of ‘const’ last in a function declaration of a class?
  4. What is an ‘undeclared identifier’ error and how do I fix it?
  5. Is it possible to declare two variables of different types in a for loop?
  6. Defining static const integer members in class definition
  7. GCC and Precompiled Headers
  8. Detecting superfluous #includes in C/C++?
  9. Meaning of = delete after function declaration
  10. How should I detect unnecessary #include files in a large C++ project?
  11. What does “default” mean after a class’ function declaration?
  12. Spiral rule and ‘declaration follows usage’ for parsing C and C++ declarations
  13. How to initialize a vector in C++ [duplicate]
  14. Why does “extern const int n;” not work as expected?
  15. Circular C++ Header Includes
  16. Is there a use for function declarations inside functions?
  17. Easy rule to read complicated const declarations?
  18. Complex C declaration
  19. How to add constructors/destructors to an unnamed class?
  20. Why are forward declarations necessary? [duplicate]
  21. Has the new C++11 member initialization feature at declaration made initialization lists obsolete?
  22. Handling header files dependencies with cmake
  23. Redefinition allowed in C but not in C++?
  24. forward declaration with vector of class type – pointer to incomplete class type not allowed
  25. Is is a good practice to put the definition of C++ classes into the header file?
  26. Where ampersand “&” can be put when passing argument by reference?
  27. What is the purpose of forward declaration?
  28. C++ Circular Dependency in Header Files
  29. What is the meaning of ‘const’ at the end of a member function declaration?
  30. Free function versus member function

Leave a Comment