C++11 has this new feature that allows programmer to remove:
- automatically generated method or operator,
- overload of free function or method (from implicit conversion)
- specialization of template method.
This can be done by marking any function with = delete keyword and it works like this:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
| void foo(unsigned a)
{}
void foo(int) = delete; // deleted function overload for implicit conversion to int
template<class T>
void bar(T a)
{}
template<class T>
void bar<double>(double) = delete; // deleted template function specialization for double type
struct Foo
{
Foo& operator=(Foo const&) = delete; // deleted defaultly generated copying assignment operator
void call(unsigned a) {}
void call(int a) = delete; // deleted method overload for implicit conversion to int
};
int main()
{
foo(1u);
//foo(2); // error: use of deleted function 'void foo(int)'
bar(Foo());
//bar(4.0); // error: use of deleted function 'void bar(T) [with T = double]'
Foo f;
f.call(1u);
//f.call(2); // error: use of deleted function 'virtual void Foo::call(int)'
Foo ff;
//ff = f; // error: use of deleted function 'Foo& Foo::operator=(const Foo&)'
} |
void foo(unsigned a)
{}
void foo(int) = delete; // deleted function overload for implicit conversion to int
template<class T>
void bar(T a)
{}
template<class T>
void bar<double>(double) = delete; // deleted template function specialization for double type
struct Foo
{
Foo& operator=(Foo const&) = delete; // deleted defaultly generated copying assignment operator
void call(unsigned a) {}
void call(int a) = delete; // deleted method overload for implicit conversion to int
};
int main()
{
foo(1u);
//foo(2); // error: use of deleted function 'void foo(int)'
bar(Foo());
//bar(4.0); // error: use of deleted function 'void bar(T) [with T = double]'
Foo f;
f.call(1u);
//f.call(2); // error: use of deleted function 'virtual void Foo::call(int)'
Foo ff;
//ff = f; // error: use of deleted function 'Foo& Foo::operator=(const Foo&)'
}
It is pretty simple and useful. This allows to remove not wanted specialization from any interface, e.g. overloaded signed value if unsigned and only unsigned value is required. Let consider following class hierarchy:
1
2
3
4
5
6
7
8
| struct Foo
{
virtual void call(unsigned a) {}
};
struct Bar : Foo
{
}; |
struct Foo
{
virtual void call(unsigned a) {}
};
struct Bar : Foo
{
};
What if it is necessary to remove an overload of call method with int argument from interface of base class? Let see what will happen if different variants of call method are called from base class and derived class.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
| struct Foo
{
void call(unsigned a) {}
void call(int) = delete;
};
struct Bar : Foo
{
};
int main()
{
Bar b;
b.call(1u);
//b.call(1); // error: use of deleted function 'void Foo::call(int)'
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
} |
struct Foo
{
void call(unsigned a) {}
void call(int) = delete;
};
struct Bar : Foo
{
};
int main()
{
Bar b;
b.call(1u);
//b.call(1); // error: use of deleted function 'void Foo::call(int)'
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
}
It works fine. Bar class uses Foo class method declaration so it is not possible to call the call method from both Foo and Bar classes. But what if a programmer would like to have the call method virtual and overridden in derived class?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| struct Foo
{
virtual void call(unsigned a) {}
void call(int) = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {}
};
int main()
{
Bar b;
b.call(1u);
b.call(1); // works since it's not deleted in derived class and can be implicitely casted to unsigned
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
} |
struct Foo
{
virtual void call(unsigned a) {}
void call(int) = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {}
};
int main()
{
Bar b;
b.call(1u);
b.call(1); // works since it's not deleted in derived class and can be implicitely casted to unsigned
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
}
Now it is possible to call the call method from Bar class but not from Foo class. But what if ‘virtual’ is put before void call(int) = delete?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| struct Foo
{
virtual void call(unsigned a) {}
virtual void call(int) = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {}
};
int main()
{
Bar b;
b.call(1u);
b.call(1); // works since it's not deleted in derived class and can be implicitely casted to unsigned
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
} |
struct Foo
{
virtual void call(unsigned a) {}
virtual void call(int) = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {}
};
int main()
{
Bar b;
b.call(1u);
b.call(1); // works since it's not deleted in derived class and can be implicitely casted to unsigned
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
}
It seems it does not matter if function is virtual or not. But there is another keyword that works with inheritence – final which means that virtual method marked with this keyword cannot be overriden in derived class.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| struct Foo
{
virtual void call(unsigned a) {}
virtual void call(int) final = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {}
};
int main()
{
Bar b;
b.call(1u);
b.call(1); // works since it's not deleted in derived class and can be implicitely casted to unsigned
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
} |
struct Foo
{
virtual void call(unsigned a) {}
virtual void call(int) final = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {}
};
int main()
{
Bar b;
b.call(1u);
b.call(1); // works since it's not deleted in derived class and can be implicitely casted to unsigned
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
}
It does not matter either if method is final or not. So one and only option is just to declare the call method with int argument as deleted in derived class which should be a first choice of those considerations.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
| struct Foo
{
virtual void call(unsigned a) {}
virtual void call(int) final = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {}
//void call(int) = delete; // error: use of deleted function 'virtual void Bar::call(int)'
};
int main()
{
Bar b;
b.call(1u);
b.call(1); // works since it's not deleted in derived class and can be implicitely casted to unsigned
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
} |
struct Foo
{
virtual void call(unsigned a) {}
virtual void call(int) final = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {}
//void call(int) = delete; // error: use of deleted function 'virtual void Bar::call(int)'
};
int main()
{
Bar b;
b.call(1u);
b.call(1); // works since it's not deleted in derived class and can be implicitely casted to unsigned
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
}
Ooops. Method void call(int) is marked as final in base class so it is not even possible to declare it as deleted in derived class. The one and only valid example that works as it supposed to from the beginning look like this:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
| struct Foo
{
virtual void call(unsigned a) {}
void call(int) = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {} // If we want to override call()
using Foo::call; // if we want to use Foo::call()
void call(int) = delete;
};
int main()
{
Bar b;
b.call(1u);
//b.call(1); // error: use of deleted function 'void Bar::call(int)'
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
} |
struct Foo
{
virtual void call(unsigned a) {}
void call(int) = delete;
};
struct Bar : Foo
{
void call(unsigned a) override {} // If we want to override call()
using Foo::call; // if we want to use Foo::call()
void call(int) = delete;
};
int main()
{
Bar b;
b.call(1u);
//b.call(1); // error: use of deleted function 'void Bar::call(int)'
Foo & f = b;
f.call(1u);
//f.call(1); // error: use of deleted function 'void Foo::call(int)'
}
In conclusion it is not possible to declare the method overload as deleted in base class so that it will affect derived class if base method is marked as virtual and overriden in derived class. This concerns mostly the interfaces with methods that may accept some unsigned key value while there exists some signed key type, that should not be passed to considered methods.
—
All examples were compiled with GCC 5.2 with –std=c++14 flag.