C++のコンパイルエラーの中でも、特に頻繁に遭遇するのが「error: no matching function for call to」というメッセージです。

このエラーは、プログラム内で呼び出そうとしている関数が、定義されている関数のいずれとも一致しない場合に発生します。

コンパイラは関数名自体は見つけていますが、引数の型や数、あるいは修飾子の違いによって、適切な実装を特定できない状態にあります。

本記事では、このエラーが発生する主な原因を整理し、最新のC++20やC++23などの仕様も踏まえた具体的な解決策を詳しく解説します。

目次 [ close ]
  1. 「error: no matching function for call to」とは何か
  2. エラーが発生する主な原因と対策
    1. 1. 引数の型や個数の不一致
    2. 2. const修飾子の不一致
    3. 3. テンプレート引数の推論失敗
    4. 4. 名前空間やスコープの問題
    5. 5. 継承関係における名前隠蔽（Name Hiding）
  3. エラーを特定するためのデバッグ手順
  4. Modern C++（C++20/23）における注意点
  5. エラー解決に役立つチェックリスト
  6. まとめ

「error: no matching function for call to」とは何か

このエラーは、C++のオーバーロード解決（Overload Resolution）というプロセスが失敗したことを意味します。

C++では同じ名前の関数を複数定義できますが、呼び出し時には引数の情報をもとに最適な関数が一つだけ選ばれる必要があります。

もし適切な候補が見つからない場合や、逆に候補が多すぎて一つに絞り込めない場合に、コンパイラはこのエラーを出力します。

エラーメッセージの後には、通常「note: candidate function not viable」といった補足情報が続き、なぜ候補が外れたのかが示されます。

この補足情報を読み解くことが、エラー解決の最短ルートとなります。

エラーが発生する主な原因と対策

「error: no matching function for call to」が発生する理由は多岐にわたりますが、大きく分けると5つのパターンに分類できます。

1. 引数の型や個数の不一致

最も単純な原因は、関数定義で指定された引数の型や数と、呼び出し側の指定が異なっているケースです。

C++は静的型付け言語であるため、暗黙の型変換ができない組み合わせでは呼び出しに失敗します。

C++
// 関数定義
void display(int value) {
    // 処理
}

int main() {
    // 文字列を渡しているため、intを受け取るdisplay関数とは一致しない
    display("Hello"); 
    return 0;
}
実行結果
error: no matching function for call to 'display(const char [6])'
note: candidate function not viable: no known conversion from 'const char [6]' to 'int' for 1st argument

この場合の修正方法は、呼び出し側の型を合わせるか、新しい型に対応したオーバーロードを追加することです。

また、デフォルト引数が設定されていない関数に対して、引数を省略して呼び出した場合も同様のエラーになります。

2. const修飾子の不一致

クラスのメンバ関数を呼び出す際、オブジェクトがconstであるにもかかわらず、非constメンバ関数を呼び出そうとするとこのエラーが発生します。

これは、constオブジェクトからは状態を変更する可能性のある操作を禁止するというC++の言語仕様によるものです。

C++
class MyClass {
public:
    void print() { // constが付いていない
        // 処理
    }
};

void process(const MyClass& obj) {
    obj.print(); // ここでエラーが発生
}

このエラーを解決するには、状態を変更しないメンバ関数にconst修飾子を付与する必要があります。

具体的には、void print() const { ... }のように宣言することで、constオブジェクトからも呼び出し可能になります。

3. テンプレート引数の推論失敗

テンプレート関数を使用している場合、コンパイラが引数からテンプレートパラメータを推論できないときにこのエラーが発生します。

特に、複数の引数で同じテンプレート型を使用している際に、異なる型を渡してしまうと推論の矛盾が生じます。

C++
template <typename T>
void compare(T a, T b) {
    // 処理
}

int main() {
    // int型とdouble型を渡しているため、Tが特定できない
    compare(10, 5.5); 
    return 0;
}

この場合、compare<double>(10, 5.5)のように明示的に型を指定するか、static_cast<double>(10)のように型を揃える必要があります。

最新のC++では、std::common_typeなどを用いて柔軟に型を扱う設計にすることも検討されます。

4. 名前空間やスコープの問題

関数は定義されているものの、呼び出し箇所からその関数が見えていない場合に発生することがあります。

名前空間（namespace）の指定が漏れている場合や、引数依存名前探索（ADL）が機能しない条件でよく見られます。

例えば、std::などのプレフィックスが必要な場所で省略されていないか確認してください。

また、ヘッダーファイルのインクルード忘れによって、前方宣言のみが認識されている場合も不一致の原因となります。

5. 継承関係における名前隠蔽（Name Hiding）

基底クラスで定義された関数と同じ名前の関数を派生クラスで定義すると、基底クラスの関数が隠蔽されることがあります。

これを「名前隠蔽」と呼び、派生クラスのインスタンスから基底クラスのオーバーロードを呼び出そうとすると「一致する関数がない」と判断されます。

C++
class Base {
public:
    void func(int x) {}
};

class Derived : public Base {
public:
    void func(std::string s) {} // 基底クラスのfunc(int)を隠蔽する
};

int main() {
    Derived d;
    d.func(10); // エラー：Derived::func(std::string)しか見えない
    return 0;
}

この問題を解決するには、派生クラス内でusing Base::func;と記述し、基底クラスの関数を現在のスコープに導入する必要があります。

エラーを特定するためのデバッグ手順

複雑なコードでこのエラーに遭遇した際は、以下のステップで原因を特定しましょう。

  1. コンパイラが出力する「candidates」リストをすべて確認する。
  2. 呼び出し側の引数の型をtypeidやdecltype、あるいはIDEのホバー機能で再確認する。
  3. 関数のシグネチャにconst、&、&&（右辺値参照）が正しく付いているか確認する。
  4. テンプレートの場合は、型推論の結果が意図通りか、明示的に型を指定してビルドが通るか試す。

特に大規模なプロジェクトでは、暗黙のコンストラクタ呼び出しが原因で意図しない型変換が試みられ、結果的に不一致となるパターンも多いです。

不要な暗黙変換を防ぐためには、コンストラクタにexplicitキーワードを付与することが推奨されます。

Modern C++（C++20/23）における注意点

C++20以降では「Concepts（コンセプト）」の導入により、このエラーの意味合いがより具体的になりました。

テンプレート関数に制約（requires句）が付いている場合、引数の型がその制約を満たさないと候補から外れます。

C++
#include <concepts>

// 整数型のみを受け付ける制約
void process_data(std::integral auto value) {
    // 処理
}

int main() {
    process_data(3.14); // double型はintegralではないためエラー
    return 0;
}

この場合、コンパイラは「requires句を満たさないため、候補から除外されました」という非常に親切なメッセージを表示します。

最新の環境では、コンセプトによる制約エラーを読み解くことが、従来の型不一致エラーの解決と同様に重要となります。

エラー解決に役立つチェックリスト

エラーの原因がどうしても分からない場合は、以下の表を参考にコードをチェックしてみてください。

チェック項目確認内容解決のヒント
引数の数関数の引数リストと呼び出し側の個数は一致しているか？デフォルト引数の有無を確認。
const性constオブジェクトから非const関数を呼んでいないか？メンバ関数にconstを付与するか検討。
参照の不一致右辺値（一時オブジェクト）を左辺値参照に渡そうとしていないか？const参照にするか、右辺値参照を使用。
テンプレートテンプレート引数の型推論が矛盾していないか？明示的なテンプレート引数の指定を試す。
名前空間正しい名前空間内にその関数は存在するか？Using宣言やフルネームでの指定を確認。

まとめ

「error: no matching function for call to」は、C++開発において非常に頻繁に発生するエラーですが、そのメッセージには解決のための重要なヒントが詰まっています。

コンパイラが提示する候補関数（candidates）と、実際に渡している引数の型を丁寧に比較することが解決の第一歩です。

近年では、C++20のコンセプトなどの新機能により、エラーメッセージが以前よりも分かりやすくなる傾向にあります。

まずは落ち着いてエラーログの「note」部分を読み、型、個数、修飾子、スコープのどこに差異があるのかを見極めましょう。

適切な型設計と制約の活用を行うことで、この種のエラーを未然に防ぎ、より堅牢なプログラムを記述できるようになります。