All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
Namespaces

Namespaces can be used to organize large projects in logical units that may be easier to remember. When using namespaces it is also not necessary to worry about using names for entities that may exist in a different part of the project under a different namespace.

      namespace A
      {
        // Entities in a namespace see each other normally.
        void function() { variable++; }
        int variable;
      }

      namespace B
      {
        // Entities in different namespaces don't immediately see each other and
        // can reuse the same name without causing name conflicts. By using the
        // scoping operator the entity from the desired namespace can be explicitly
        // informed.
        void function() { A::function(); }
      }

Observe that in order to refer to an entity from a different namespace the scoping operator must be used, unless it is a parent namespace in which case it is only necessary if the child namespace declare the same entity.

      int var;
      namespace Parent
      {
        int var;
        namespace Child
        {
          int var;
          void func()
          {
            // Accessing variable in parent namespace requires
            // specifying the scope if an entity in a child namespace
            // uses the same name
            var = Parent::var;

            // To access variables in global scope the scoping
            // operator without any name should be used
            Parent::var = ::var;
          }
        }
      }

      void func()
      {
        // Access variable in a nested namespace requires
        // fully qualified scope specifier
        int var = Parent::Child::var;
      }