C++ error: no matching function for call to

error: no matching function for call to 'f(...)' means the compiler found functions named f, but none of them can be called with the argument types you passed. The error line shows the call as the compiler sees it, with the argument types; the note: candidate: lines below list every overload it considered and why each failed (wrong number of arguments, no conversion from one type to another, const mismatch). Change the arguments to match a candidate, or add or fix the overload.

The message appears for overloaded functions, constructors and templates. When there is only one candidate, GCC usually reports a more specific error instead, such as could not convert or cannot bind non-const lvalue reference.

Example

#include <algorithm>

struct Point {
    Point(int x, int y) : x(x), y(y) {}
    int x, y;
};

int main() {
    Point p;                     // no constructor takes zero arguments
    auto m = std::max(1, 2.0);   // int and double: no single T can be deduced
}

GCC reports one error per call. For Point p; the message is no matching function for call to 'Point::Point()', followed by notes for the candidates Point(int, int) and the implicit copy and move constructors, each with the reason it does not fit. For std::max(1, 2.0) the notes say that template argument deduction found conflicting types for the parameter (int and double).

Fixes

#include <algorithm>

struct Point {
    Point() = default;                    // or give the members default values
    Point(int x, int y) : x(x), y(y) {}
    int x = 0, y = 0;
};

int main() {
    Point p;
    Point q{1, 2};
    auto m = std::max<double>(1, 2.0);    // explicit template argument
    auto n = std::max(1.0, 2.0);          // or arguments of the same type
}

Common patterns