コンパイラエラー

C2935エラーについて解説: Visual Studioでのグローバル関数再定義問題と対処法

2025-03-29更新日: 2025-03-29

Visual Studio環境で発生するC2935エラーは、グローバル関数としてジェネリックやテンプレートクラスを再定義しようとする際に表示されます。

コード内の中かっこの不一致なども原因となることがあり、正しいクラス定義と関数実装に注意が必要です。

なお、Visual Studio 2022以降ではこのエラーは廃止されています。

目次から探す

エラー発生の背景と原因
- C2935エラーの概要
- 発生原因の詳細
Visual Studioのバージョン別挙動
- Visual Studio 2022以前の場合
- Visual Studio 2022以降の場合
コード記述上の注意点と対策
- クラスと関数の正しい定義方法
- エラー回避のための実践例
ビルド環境とデバッグのポイント
- コンパイルオプションの確認手順
- デバッグ時の確認事項
まとめ

エラー発生の背景と原因

C2935エラーの概要

エラーコードの意味

エラーコード C2935 は、グローバル関数として再定義された型クラスが原因で発生するエラーであると説明されます。

具体的には、ジェネリッククラスやテンプレートクラスがグローバル関数として定義されようとした場合に、コンパイラが正しく認識できず、問題が発生する状況を示しています。

たとえば、クラス名と同じ名前のグローバル関数を定義すると、再定義としてエラーとなります。

グローバル関数再定義の問題点

グローバル関数として同一のクラスやテンプレートを再定義すると、宣言の重複や意味の混乱から意図しない動作に繋がる可能性があります。

特に、コンパイラはどの定義を使用するべきか曖昧になり、予期せぬ挙動やコンパイルエラーを引き起こすため、コードの明確さと管理が重要となります。

発生原因の詳細

テンプレートクラスの不適切な使用

テンプレートクラスでは、型パラメータを用いて柔軟な実装が可能ですが、不適切な場所でグローバル関数としてインスタンス化しようとすると C2935 エラーが発生します。

たとえば、以下のようにテンプレートクラス TemplateClass を定義しながら、同じ名前でグローバルな関数を定義するとエラーになります。

#include <iostream>
// テンプレートクラスの定義
template <class T>
struct TemplateClass {
    void display() {
        std::cout << "TemplateClassのインスタンスです。" << std::endl;
    }
};
// 以下のグローバル関数の定義は不適切であるためエラーが発生します
// void TemplateClass<int>() {}   // C2935エラーの例
int main() {
    std::cout << "テンプレートクラスの不適切な使用例です。" << std::endl;
    return 0;
}

テンプレートクラスの不適切な使用例です。

ジェネリッククラスの誤用

C++/CLI などの環境では、generic キーワードを利用してジェネリッククラスを定義できます。

しかし、これらの場合も同様に、グローバル関数として同一の名前で定義を試みると C2935 エラーが発生することがあります。

ジェネリッククラスは、メンバー関数やクラス内での利用に留めることで、エラーの回避が可能です。

#include <iostream>
using namespace System;
using namespace std;
// C++/CLI の場合のジェネリッククラス定義(/clr オプションでコンパイルしてください)
generic <class T>
ref struct GenericClass {
    void Show() {
        // Console::WriteLine を利用して出力する例です
        Console::WriteLine("GenericClassのインスタンスです。");
    }
};
int main(array<System::String ^> ^args) {
    // 以下のグローバル関数定義がないことを確認してください
    GenericClass<int>^ obj = gcnew GenericClass<int>();
    obj->Show();
    return 0;
}

GenericClassのインスタンスです。

中かっこの不一致による問題

中かっこの開閉が正しく管理されていない場合、コンパイラは意図しない解釈を行い、クラス定義や関数定義と誤認識することがあります。

例えば、クラス定義の終了位置が曖昧になると、後続のコードがグローバルな関数定義として扱われ、C2935 が発生する可能性があります。

プログラマーは中かっこの対応関係を意識することでこの問題を回避できます。

Visual Studioのバージョン別挙動

Visual Studio 2022以前の場合

エラー発生例の特徴

Visual Studio 2022以前のバージョンでは、グローバル関数として同名の型クラスやテンプレートクラスを再定義しようとすると、コンパイラが C2935 エラーを出力します。

この挙動は、従来のコンパイラ設計に起因しており、エラーが発生するパターンとして下記のような例が挙げられます。

テンプレートクラスと同じ名前のグローバル関数の宣言
中かっこの不一致による誤解釈

コード例では、テンプレートクラス TemplateClass のグローバル関数定義を試みると、コンパイル時にエラーが報告されるため、開発時に注意が必要です。

Visual Studio 2022以降の場合

エラー廃止の経緯

Visual Studio 2022 以降のバージョンでは、一部のグローバル関数再定義に関するルールが変更され、C2935 エラーが廃止されています。

これは、最新のコンパイラ改善により、中かっこの対応やテンプレートの処理がより柔軟かつ正確に行われるようになったためです。

開発環境が Visual Studio 2022 以降の場合は、従来のエラーが発生しないケースが多いため、エラー対策の必要性が低減されます。

コード記述上の注意点と対策

クラスと関数の正しい定義方法

グローバルとローカルの区別

プログラム内でのグローバル定義とローカル定義の区別を明確にすることが大切です。

クラスやテンプレートは、グローバルスコープで定義することが可能ですが、同じ名前で関数を定義すると混乱が生じるため、必ずローカルなスコープで関数を実装するか、名前を変更する工夫が必要です。

たとえば、クラスのメンバー関数として定義することでグローバルな再定義を避けることができます。

中かっこの整合性チェック

中かっこの開閉が正しく行われているか確認することは、エラー防止の基本です。

エディタの自動補完機能やコード整形ツールを利用すると、意図せぬ中かっこの不一致を発見しやすくなります。

以下に、正しく記述されたコード例を示します。

#include <iostream>
using namespace std;
// 正しいクラス定義の例
class MyClass {
public:
    void PrintMessage() {
        cout << "MyClassのメンバー関数が呼び出されました。" << endl;
    }
};  // 中かっこが正しく閉じています
int main() {
    MyClass obj;
    obj.PrintMessage();
    return 0;
}

MyClassのメンバー関数が呼び出されました。

エラー回避のための実践例

テンプレートクラスの適正な実装

テンプレートクラスを使用する際は、クラスの宣言と同名のグローバル関数定義を行わないようにコーディングすることが大切です。

以下のサンプルは、テンプレートクラスの正しい実装例です。

#include <iostream>
using namespace std;
// テンプレートクラスの正しい定義
template <class T>
struct TemplateClass {
    void display() {
        cout << "TemplateClassのインスタンスです。" << endl;
    }
};
int main() {
    TemplateClass<int> obj; // int型のインスタンスを作成
    obj.display();
    return 0;
}

TemplateClassのインスタンスです。

ジェネリッククラスの修正例

C++/CLI 環境でジェネリッククラスを利用する場合も、グローバル関数として再定義するのではなく、クラス内のメンバーとして実装するように工夫します。

以下のサンプルは、ジェネリッククラスの正しい使用例です(/clr オプションでコンパイルしてください)。

#include <iostream>
using namespace System;
using namespace std;
// C++/CLI におけるジェネリッククラスの正しい定義
generic <class T>
ref struct GenericClass {
    void Show() {
        // Console::WriteLine を利用して出力
        Console::WriteLine("GenericClassのインスタンスです。");
    }
};
int main(array<System::String ^> ^args) {
    GenericClass<int>^ obj = gcnew GenericClass<int>(); // int型のインスタンスを作成
    obj->Show();
    return 0;
}

GenericClassのインスタンスです。

ビルド環境とデバッグのポイント

コンパイルオプションの確認手順

設定項目のチェック方法

使用している開発環境でコンパイルオプションの設定を確認することは非常に重要です。

Visual Studio のプロジェクトプロパティから以下の項目をチェックできます。

「C/C++」→「全般」→「追加のインクルードディレクトリ」
「C/C++」→「言語」→「コンパイラ拡張機能の有効化」
「全般」→「プラットフォームツールセット」

これらの設定が適切に行われているか確認することで、意図しないエラーの発生を防ぐ手助けとなります。

デバッグ時の確認事項

不一致箇所の特定方法

デバッグ時には、中かっこの不一致や関数の定義が意図したスコープ内に収まっているか確認する必要があります。

具体的には、以下の方法で問題箇所を特定できます。

エディタの構文ハイライト機能を利用する
コンパイル時に発生するエラーメッセージを参照する
コード整形ツールやリントツールで自動チェックを実施する

これらの手法を用いて、不一致や重複定義がないかを念入りに確認してください。

まとめ

この記事では、C2935 エラーの定義と発生原因、グローバル関数としての再定義による問題点について解説しています。

テンプレートクラスやジェネリッククラスを正しく定義する方法、また中かっこの整合性を保つ重要性が具体例と共に説明されました。

さらに、Visual Studio 2022以前と以降のエラー挙動の違いや、コンパイルオプションやデバッグ時に確認すべきポイントについても説明しており、エラー回避のための実践的な対策が理解できます。