operator==,!=(std::function)

From cppreference.com
< cpp‎ | utility‎ | functional‎ | function
 
 
Utilities library
General utilities
Date and time
Function objects
Formatting library (C++20)
(C++11)
Relational operators (deprecated in C++20)
Integer comparison functions
(C++20)(C++20)(C++20)   
(C++20)
Swap and type operations
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Common vocabulary types
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
Elementary string conversions
(C++17)
(C++17)
 
Function objects
Function wrappers
(C++11)
(C++11)
Partial function application
(C++20)(C++23)
(C++11)
Function invocation
(C++17)(C++23)
Identity function object
(C++20)
Reference wrappers
(C++11)(C++11)
Transparent operator wrappers
(C++14)
(C++14)
(C++14)
(C++14)  
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)

Negators
(C++17)
Searchers
Constrained comparators
Old binders and adaptors
(until C++17*)
(until C++17*)
(until C++17*)
(until C++17*)
(until C++17*)(until C++17*)(until C++17*)(until C++17*)
(until C++20*)
(until C++20*)
(until C++17*)(until C++17*)
(until C++17*)(until C++17*)

(until C++17*)
(until C++17*)(until C++17*)(until C++17*)(until C++17*)
(until C++20*)
(until C++20*)
 
 
Defined in header <functional>
template< class R, class... ArgTypes >

bool operator==( const std::function<R(ArgTypes...)>& f,

                 std::nullptr_t ) noexcept;
(1) (since C++11)
template< class R, class... ArgTypes >

bool operator==( std::nullptr_t,

                 const std::function<R(ArgTypes...)>& f ) noexcept;
(2) (since C++11)
(until C++20)
template< class R, class... ArgTypes >

bool operator!=( const std::function<R(ArgTypes...)>& f,

                 std::nullptr_t ) noexcept;
(3) (since C++11)
(until C++20)
template< class R, class... ArgTypes >

bool operator!=( std::nullptr_t,

                 const std::function<R(ArgTypes...)>& f ) noexcept;
(4) (since C++11)
(until C++20)

Compares a std::function with a null pointer. Empty functions (that is, functions without a callable target) compare equal, non-empty functions compare non-equal.

The != operator is synthesized from operator==.

(since C++20)

Parameters

f - std::function to compare

Return value

1-2) !f
3-4) (bool) f

Example

#include <functional>
#include <iostream>
 
using SomeVoidFunc = std::function<void(int)>;
 
class C {
public:
    C(SomeVoidFunc void_func = nullptr) : 
        void_func_(void_func)
    {
        if (void_func_ == nullptr) { // specialized compare with nullptr
            void_func_ = std::bind(&C::default_func, this, std::placeholders::_1);
        }
        void_func_(7);
    }
 
    void default_func(int i) { std::cout << i << '\n'; };
 
private:
    SomeVoidFunc void_func_;
};
 
void user_func(int i)
{
    std::cout << (i + 1) << '\n';
}
 
int main()
{
    C c1;
    C c2(user_func);
}

Output:

7
8

See also

compares a std::move_only_function with nullptr
(function)