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 );		(до C++14)
constexpr explicit binary_negate( Predicate const& pred );		(с C++14)

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

Параметры

pred

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

std::binary_negate::operator()

bool operator()( first_argument_type const& x, second_argument_type const& y ) const;		(до C++14)
constexpr bool operator()( first_argument_type const& x, second_argument_type const& y ) const;		(с 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/w/cpp/utility/functional/binary_negate