# std::unary_function

> C++ Atlas: `cppatlas.com/w/cpp/utility/functional/unary_function` | Source: https://en.cppreference.com/w/cpp/utility/functional/unary_function | Domain: Utility | Standards: C++11, C++17, C++23

std::unary_function is a base class for creating function objects with one argument.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <functional>

template< typename ArgumentType, typename ResultType >
struct unary_function; // (deprecated in C++11) (removed in C++17)
```

`std::unary_function` is a base class for creating function objects with one argument.

`std::unary_function` does not define `operator()`; it is expected that derived classes will define this. `std::unary_function` provides only two types - `argument_type` and `result_type` - defined by the template parameters.

Some standard library function object adaptors, such as `std::not1`, require the function objects they adapt to have certain types defined; `std::not1` requires the function object being adapted to have a type named `argument_type`. Deriving function objects that take one argument from `std::unary_function` is an easy way to make them compatible with those adaptors.

`std::unary_function` is deprecated in C++11.

### Member types

**Type — Definition**

- `argument_type`: `ArgumentType`
- `result_type`: `ResultType`

### Example

```cpp
#include <algorithm>
#include <functional>
#include <iostream>
#include <vector>

struct less_than_7 : std::unary_function<int, bool>
{
    bool operator()(int i) const { return i < 7; }
};

int main()
{
    std::vector<int> v(10, 7);
    v[0] = v[1] = v[2] = 6;

    std::cout << std::count_if(v.begin(), v.end(), std::not1(less_than_7()));

    // C++11 solution:
    // Cast to std::function<bool (int)> somehow - even with a lambda
    // std::cout << std::count_if(v.begin(), v.end(),
    //     std::not1(std::function<bool (int)>([](int i) { return i < 7; })));
}
```

Output:

```text
7
```

### See also

- [`function`](https://en.cppreference.com/w/cpp/utility/functional/function) (C++11): copyable wrapper of any copy constructible callable object (class template)
- [`move_only_function`](https://en.cppreference.com/w/cpp/utility/functional/move_only_function) (C++23): move-only wrapper of any callable object that supports qualifiers in a given call signature (class template)
- [`ptr_fun`](https://en.cppreference.com/w/cpp/utility/functional/ptr_fun) (deprecated in C++11): creates an adaptor-compatible function object wrapper from a pointer to function (function template)
- [`pointer_to_unary_function`](https://en.cppreference.com/w/cpp/utility/functional/pointer_to_unary_function) (deprecated in C++11): adaptor-compatible wrapper for a pointer to unary function (class template)
- [`binary_function`](https://en.cppreference.com/w/cpp/utility/functional/binary_function) (deprecated in C++11): adaptor-compatible binary function base class (class template)

---
Attribution: content from https://en.cppreference.com/w/cpp/utility/functional/unary_function (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.