第11回 namespace と using

1. なぜ namespace が必要か（C と比較）

C 言語では、関数・グローバル変数の名前はプログラム全体で一意でなければなりません。プロジェクトが大きくなると、自作のライブラリと外部ライブラリで同名関数を作ってしまい、リンク時に「multiple definition of …」エラーで衝突します。

C 時代の「プレフィックス命名規約」（graphics_init, audio_init）は、名前空間の手動エミュレーションです。C++ では言語機構として正式にサポートされ、フォルダ階層のように識別子を整理できます。

標準ライブラリは std という大きなフォルダの中に全機能が入っているイメージです。

2. namespace の定義と参照

名前空間を作るのも、参照するのも文法は素直です。

定義：namespace 名前 { … }

// my_app.hpp
namespace my_app {
    constexpr int VERSION = 2;

    int add(int a, int b) { return a + b; }

    class User { /* … */ };
}

参照：名前空間::識別子

int v = my_app::VERSION;
int s = my_app::add(1, 2);
my_app::User u;

:: はスコープ解決演算子と呼ばれ、「この名前空間（またはクラス）の中の」を意味します。std::cout も同じ仕組みで、「std 名前空間の cout」と読みます。

3. using 宣言と using ディレクティブ

毎回 std:: を書くのが冗長な場面があります。それを省略する仕組みが using ですが、書き方によって「取り込みの強さ」が違います。

using 宣言（using std::cout;）

「この識別子だけを今のスコープに取り込む」という限定的な指定です。取り込む識別子が明示されているため、何が入るかが一目で分かります。

using ディレクティブ（using namespace std;）

その名前空間の全識別子を取り込みます。便利ですが、std には count, distance, size, find など一般的な名前が大量にあるため、自作の関数や他ライブラリと衝突する危険があります。

使い分けの判断表

4. 入れ子名前空間と namespace alias

入れ子名前空間

名前空間はフォルダのように入れ子にできます。標準ライブラリの std::filesystem や std::ranges::views も入れ子名前空間です。

// 従来の書き方
namespace my_app {
    namespace network {
        void connect() { /* … */ }
    }
}
my_app::network::connect();

// C++17 以降の短縮記法
namespace my_app::network {
    void connect() { /* … */ }
}

namespace alias

長い名前空間に別名を付けて、参照を短くできます。

// std::filesystem を fs として使う（実務でよくある書き方）
namespace fs = std::filesystem;

fs::create_directory("work");
for (auto& e : fs::directory_iterator(".")) {
    std::cout << e.path() << "\n";
}

alias は関数スコープ・名前空間スコープのどちらにも書けます。長い識別子を毎回書く負担を減らしつつ、using namespace のような名前空間汚染も起きないため、長い名前空間と付き合う最良の方法です。

5. 無名名前空間（static の代替）

C で「ファイル内だけで使う関数・変数」を作るときは static を付けていました。C++ にはより現代的な無名名前空間という仕組みがあり、こちらが推奨されます。

無名名前空間に入れた識別子は、コンパイラが自動的にそのファイル固有の名前空間名を割り当てます。結果としてファイル外からは参照できなくなり、static と同じ「内部リンケージ」効果が得られます。

6. 使い分けのまとめ

覚える結論はシンプルです。次の 4 つだけ押さえれば、本サイトの全章のコードが読めるようになります。

• 標準ライブラリの呼び出しは std::cout, std::vector のように毎回 std:: を付ける（本サイト方針）
• 長い名前空間は namespace fs = std::filesystem; のように alias で短縮する
• 関数スコープに限って using std::cout;（using 宣言）で識別子を絞り込んで取り込むのは可
• ヘッダファイルでは絶対に using namespace std; を書かない