毎回書いているstd::coutのstdは、何なのでしょうか。実は、これもnamespaceの1つです。プロジェクトが大きくなると、別々の場所で同じ名前の関数やクラスを作って、ぶつかることがあります。namespaceは、その衝突を防いで、コードを整理するための仕組みです。
この記事では、namespaceの意味と使い方、using宣言の注意点、初心者がハマりやすいミスを解説します。
namespaceとは？
namespace（名前空間）とは、名前をグループにまとめて、衝突を防ぐ仕組みです。同じ Init という関数でも、別の namespace に入れておけば区別できます。
#include <iostream>
namespace Audio {
void Init() { std::cout << "サウンド初期化\n"; }
}
namespace Input {
void Init() { std::cout << "入力初期化\n"; }
}
int main() {
Audio::Init(); // どっちのInitか明確
Input::Init();
return 0;
}サウンド初期化
入力初期化同じ Init でも、Audio::Init と Input::Init で区別できました。名前空間::名前 の形で呼ぶのが基本です。
なぜnamespaceが必要？
理由は、大きなプロジェクトやライブラリでは名前がぶつかりやすいからです。自分のコードと外部ライブラリで同じ名前の関数があると、どちらを呼んでいるのか分からずエラーになります。namespaceで区切っておけば安心です。
ファイルを分割する仕組みと合わせて使うと整理しやすくなります（インクルードガードの記事もどうぞ）。
using宣言と注意点
毎回 std:: を書くのが面倒なとき、using namespace std; と書くと省略できます。ただしこれはヘッダファイル（.h）には書かないのが鉄則です。
#include <iostream>
using namespace std; // .cpp の中ならOK
int main() {
cout << "std:: を省略できる\n";
return 0;
}std:: を省略できるヘッダに書くと、そのヘッダを読み込んだ全ファイルに影響してしまい、namespaceのメリットが台無しになります。使うなら .cpp の中だけにしましょう。
【重要】私が実際にnamespaceで困った体験談
個人開発で、あるサンプルのヘッダに using namespace std; が書いてあるのに気づかず自分のヘッダでも同じことをしていたら、別ライブラリの count と std::count がぶつかって「あいまいだ」というコンパイルエラーが大量発生しました。
原因は、ヘッダで using namespace をしたせいで名前が混ざったこと。ヘッダからは using namespace を全部消し、必要な所で std:: を明示するようにしたら、きれいに解決しました。「ヘッダで using namespace は禁物」と体で覚えた出来事です。
namespace使用時のよくある失敗例と対処法
①ヘッダにusing namespaceを書く
体験談のとおり、名前が混ざって衝突します。ヘッダでは書かない、が鉄則です。
②「名前空間::」を付け忘れる
namespaceの中の関数は Audio::Init() のように呼びます。付け忘れると見つからないエラーになります。
③namespaceを深くネストしすぎる
入れ子が深すぎると A::B::C::D::func() のように長くなり読みにくくなります。階層は浅めに保つのがおすすめです。
注意点
using namespaceはヘッダに書かない（.cppの中だけ）- 呼ぶときは
名前空間::名前を基本にする - ネストは浅めに、機能ごとに分けると整理しやすい
まとめ
- namespaceは名前をまとめて衝突を防ぐ仕組み
stdも namespaceの一種using namespaceは便利だがヘッダでは使わない- 機能ごとに分けると、大きなプロジェクトでも整理しやすい
using namespaceは便利ですが、ヘッダーでは使いません。機能ごとに、AudioやInputのように区切っておくと、大きなプロジェクトでも整理しやすくなります。
