std::binary_negate

Определён в заголовочном файле <functional>

Определён в заголовочном файле `<functional>`
template< class Predicate > struct binary_negate : public std::binary_function< Predicate::first_argument_type, Predicate::second_argument_type, bool >;		(до C++11)
template< class Predicate > struct binary_negate;		(начиная с C++11) (устарело в C++17) (удалено в C++20)

template< class Predicate >
struct binary_negate
    : public std::binary_function<
        Predicate::first_argument_type,
        Predicate::second_argument_type,
        bool
    >;

(до C++11)

template< class Predicate >
struct binary_negate;

(начиная с C++11)
(устарело в C++17)
(удалено в C++20)

std::binary_negate — это объект-обёртка функции, возвращающий логическое отрицание хранимого им бинарного предиката.

Тип бинарного предиката должен определять два типа-члена, first_argument_type и second_argument_type, которые могут быть преобразованы в типы параметров предиката. Типы, определённые таким образом, имеют функциональные объекты, полученные из std::owner_less, std::ref, std::cref, std::plus, std::minus, std::multiplies, std::divides, std::modulus, std::equal_to, std::not_equal_to, std::greater, std::less, std::greater_equal, std::less_equal, std::logical_not, std::logical_or, std::bit_and, std::bit_or, std::bit_xor, std::mem_fn, std::map::value_comp, std::multimap::value_comp, std::function или полученные в результате вызова std::not2, а также функциональные объекты, производные от устаревшего std::binary_function.

Объекты std::binary_negate легко создаются с помощью вспомогательной функции std::not2.

Типы-члены

Тип	Определение
`first_argument_type`	`Predicate::first_argument_type`
`second_argument_type`	`Predicate::second_argument_type`
`result_type`	bool

Функции-члены

(конструктор)	создаёт объект binary_negate с переданным предикатом (открытая функция-член)
operator()	возвращает логическое отрицание результата вызова сохранённого предиката (открытая функция-член)

std::binary_negate::binary_negate

explicit binary_negate( Predicate const& pred );

(constexpr начиная с C++14)

Создаёт функциональный объект std::binary_negate с сохранённым предикатом pred.

Параметры

pred

функциональный объект-предикат

std::binary_negate::operator()

bool operator()( first_argument_type const& x,
                 second_argument_type const& y ) const;

(constexpr начиная с C++14)

Возвращает логическое отрицание результата вызова pred(x, y).

Параметры

x	-	первый аргумент, передаваемый предикату
y	-	второй аргумент, передаваемый предикату

Возвращаемое значение

Логическое отрицание результата вызова pred(x, y).

Пример

#include <algorithm>
#include <cstddef>
#include <functional>
#include <iostream>
#include <vector>

struct same : std::binary_function<int, int, bool>
{
    bool operator()(int a, int b) const { return a == b; }
};

int main()
{
    std::vector<int> v1;
    for (int i = 0; i < 7; ++i)
        v1.push_back(i);

    std::vector<int> v2(v1.size());
    std::reverse_copy(v1.begin(), v1.end(), v2.begin());

    std::vector<bool> v3(v1.size());

    std::binary_negate<same> not_same((same()));

    // C++11 solution:
    // std::function<bool (int, int)> not_same =
    //     [](int x, int y) -> bool { return !same()(x, y); };

    std::transform(v1.begin(), v1.end(), v2.begin(), v3.begin(), not_same);

    std::cout.setf(std::ios_base::boolalpha);
    for (std::size_t i = 0; i != v1.size(); ++i)
        std::cout << v1[i] << " != " << v2[i] << " : " << v3[i] << '\n';
}

Вывод:

0 != 6 : true
1 != 5 : true
2 != 4 : true
3 != 3 : false
4 != 2 : true
5 != 1 : true
6 != 0 : true

См. также

binary_function (устарело в C++11)(удалено в C++17)	базовый класс бинарной функции, совместимый с адаптерами (шаблон класса)
function (C++11)	копируемая обёртка для любого вызываемого объекта, допускающего копирование при создании (шаблон класса)
move_only_function (C++23)	перемещаемая обёртка для любого вызываемого объекта, поддерживающего квалификаторы в заданной сигнатуре вызова (шаблон класса)
not2 (устарело в C++17)(удалено в C++20)	создаёт пользовательский объект `std::binary_negate` (шаблон функции)
ptr_fun (устарело в C++11)(удалено в C++17)	создаёт совместимую с адаптерами обёртку-функциональный объект из указателя на функцию (шаблон функции)
unary_negate (устарело в C++17)(удалено в C++20)	объект-обёртка функции, возвращающий логическое отрицание хранимого им унарного предиката (шаблон класса)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/utility/functional/binary_negate