[ fromfile: namespaces.xml id: namespaces ]

In C and C++ there is one global scope that contains

Classes are one way of grouping names (members) under a common heading (the classname), but sometimes it is desirable to have a higher-level grouping of names.

The namespace mechanism provides a way to partition the global scope into individually named sub-scopes. This helps avoid naming conflicts that can arise when developing a program that uses modules with name conflicts. The syntax for defining a namespace is

        namespace namespaceName { decl1, decl2, ...}

Any legal identifier can be used for the optional namespaceName. Example 20.12 and Example 20.13 define two separate namespaces in different files, each containing functions with the same name.

#include <iostream>
namespace A {
    using namespace std;
    void f() {
        cout << "f from A\n";
    }

    void g() {
        cout << "g from A\n";
    }
}

#include <iostream>

namespace B {
    using namespace std;
    void f() {
        cout << "f from B\n";
    }

    void g() {
        cout << "g from B\n";
    }
}

Example 20.14 includes both header files, and uses scope resolution to call functions declared in either file.

#include "a.h"
#include "b.h"

int main() {
    A::f();
    B::g();
}
Output:

f from A
g from B

The using keyword enables individual members of a namespace to be referenced without scope resolution. The syntax can take two forms.

Care must be exercised to make sure that ambiguities are not produced when identifiers are present in more than one included namespace. We show an example of such an ambiguous function call in Example 20.15.

#include "a.h"
#include "b.h"

int main() {
    using A::f;         
    f();
    using namespace B;  
    g();                
    f();                
}
Output:

f from A
g from B
f from A

	namespace Aliases
	To make sure that the names of various namespaces are unique, programmers sometimes need to produce extremely long namespace names. You can easily introduce an alias for a long namespace name with a command such as: namespace xyz = verylongcomplicatednamespacename;