Namespaces
Namespaces allow to group entities like classes, objects and functions under a name. This way the global scope can be divided in "sub-scopes", each one with its own name.
The format of namespaces is:
namespace identifier
{
entities
}
Where
identifier is any valid identifier and
entities is the set of classes, objects and functions that are included within the namespace. For example:
1 2 3 4
|
namespace myNamespace
{
int a, b;
}
| |
In this case, the variables
a and
b are normal variables declared within a namespace called
myNamespace. In order to access these variables from outside the
myNamespace namespace we have to use the scope operator
::. For example, to access the previous variables from outside
myNamespace we can write:
1 2
|
myNamespace::a
myNamespace::b
| |
The functionality of namespaces is especially useful in the case that there is a possibility that a global object or function uses the same identifier as another one, causing redefinition errors. For example:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
|
// namespaces
#include <iostream>
using namespace std;
namespace first
{
int var = 5;
}
namespace second
{
double var = 3.1416;
}
int main () {
cout << first::var << endl;
cout << second::var << endl;
return 0;
}
|
5
3.1416 | |
In this case, there are two global variables with the same name:
var. One is defined within the namespace
first and the other one in
second. No redefinition errors happen thanks to namespaces.
using
The keyword
using is used to introduce a name from a namespace into the current declarative region. For example:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
|
// using
#include <iostream>
using namespace std;
namespace first
{
int x = 5;
int y = 10;
}
namespace second
{
double x = 3.1416;
double y = 2.7183;
}
int main () {
using first::x;
using second::y;
cout << x << endl;
cout << y << endl;
cout << first::y << endl;
cout << second::x << endl;
return 0;
}
|
5
2.7183
10
3.1416 | |
Notice how in this code,
x (without any name qualifier) refers to
first::x whereas
y refers to
second::y, exactly as our
using declarations have specified. We still have access to
first::y and
second::x using their fully qualified names.
The keyword using can also be used as a directive to introduce an entire namespace:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
|
// using
#include <iostream>
using namespace std;
namespace first
{
int x = 5;
int y = 10;
}
namespace second
{
double x = 3.1416;
double y = 2.7183;
}
int main () {
using namespace first;
cout << x << endl;
cout << y << endl;
cout << second::x << endl;
cout << second::y << endl;
return 0;
}
|
5
10
3.1416
2.7183 | |
In this case, since we have declared that we were
using namespace first, all direct uses of
x and
y without name qualifiers were referring to their declarations in
namespace first.
using and
using namespace have validity only in the same block in which they are stated or in the entire code if they are used directly in the global scope. For example, if we had the intention to first use the objects of one namespace and then those of another one, we could do something like:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
|
// using namespace example
#include <iostream>
using namespace std;
namespace first
{
int x = 5;
}
namespace second
{
double x = 3.1416;
}
int main () {
{
using namespace first;
cout << x << endl;
}
{
using namespace second;
cout << x << endl;
}
return 0;
}
|
5
3.1416 | |
Namespace alias
We can declare alternate names for existing namespaces according to the following format:
namespace new_name = current_name;
Namespace std
All the files in the C++ standard library declare all of its entities within the
std namespace. That is why we have generally included the
using namespace std; statement in all programs that used any entity defined in
iostream.