std::function::operator bool

From cppreference.com
< cpp‎ | utility‎ | functional‎ | function
 
 
 
Function objects


Function wrappers
(C++11)
(C++11)
(C++17)
Bind
(C++11)
Reference wrappers
(C++11)(C++11)
Operator wrappers
Negators
(deprecated)
(deprecated)

(deprecated)
(deprecated)
Searchers
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++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)
 
 
explicit operator bool() const;
(since C++11)

Checks whether *this stores a callable function target, i.e. is not empty.

Parameters

(none)

Return value

true if *this stores a callable function target, false otherwise.

Exceptions

noexcept specification:  
noexcept
  

Example

#include <functional>
#include <iostream>
 
void sampleFunction()
{
    std::cout << "This is the sample function!\n";
}
 
void checkFunc( std::function<void()> &func )
{
    // Use operator bool to determine if callable target is available.
    if( func )  
    {
        std::cout << "Function is not empty! Calling function.\n";
        func();
    }
    else
    {
        std::cout << "Function is empty. Nothing to do.\n";
    }
}
 
int main()
{
    std::function<void()> f1;
    std::function<void()> f2( sampleFunction );
 
    std::cout << "f1: ";
    checkFunc( f1 );
 
    std::cout << "f2: ";
    checkFunc( f2 );
}

Output:

f1: Function is empty. Nothing to do.
f2: Function is not empty! Calling function.
This is the sample function!