std::mem_fun

Определено в заголовке `<functional>`
template< class Res, class T > std::mem_fun_t<Res,T> mem_fun( Res (T::*f)() );	(1)	(устарело в C++11) (удалено в C++17)
template< class Res, class T > std::const_mem_fun_t<Res,T> mem_fun( Res (T::*f)() const );	(1)	(устарело в C++11) (удалено в C++17)
template< class Res, class T, class Arg > std::mem_fun1_t<Res,T,Arg> mem_fun( Res (T::*f)(Arg) );	(2)	(устарело в C++11) (удалено в C++17)
template< class Res, class T, class Arg > std::const_mem_fun1_t<Res,T,Arg> mem_fun( Res (T::*f)(Arg) const );	(2)	(устарело в C++11) (удалено в C++17)

Создает объект-обертку для функции-члена, вычисляя целевой тип из шаблонных аргументов. Объект-обертка ожидает указатель на объект типа T в качестве первого параметра для своего operator().

1) Эффективно вызывает std::mem_fun_t<Res,T>(f) или std::const_mem_fun_t<Res,T>(f).

2) Эффективно вызывает std::mem_fun1_t<Res,T,Arg>(f) или std::const_mem_fun1_t<Res,T,Arg>(f).

Эта функция и связанные типы были устаревшими в C++11 и удалены в C++17 в пользу более общей std::mem_fn и std::bind, которые оба создают объекты-адаптеры, вызываемые из функций-членов.

Параметры

указатель на функцию-член для создания обертки

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

Объект-функция, обертывающий f.

Исключения

Может вызывать реализуемые исключения.

Примечания

Разница между std::mem_fun и std::mem_fun_ref заключается в том, что первый создает обертку функции, которая ожидает указатель на объект, а второй — ссылку.

Пример

Демонстрирует использование std::mem_fun и сравнивает его с std::mem_fn. Может потребоваться режим компиляции, совместимый с C++11/14: g++/clang++ с -std=c++11, cl с /std:c++11 и т. д. В современных компиляторах, например, gcc-12, могут быть предупреждения "устаревшее объявление", если не компилировать в режиме C++98.

#include <functional>
#include <iostream>
 
struct S
{
    int get_data() const { return data; }
    void no_args() const { std::cout << "void S::no_args() const\n"; }
    void one_arg(int) { std::cout << "void S::one_arg()\n"; }
    void two_args(int, int) { std::cout << "void S::two_args(int, int)\n"; }
#if __cplusplus > 201100
    int data{42};
#else
    int data;
    S() : data(42) {}
#endif
};
 
int main()
{
    S s;
 
    std::const_mem_fun_t<int, S> p = std::mem_fun(&S::get_data);
    std::cout << "s.get_data(): " << p(&s) << '\n';
 
    std::const_mem_fun_t<void, S> p0 = std::mem_fun(&S::no_args);
    p0(&s);
 
    std::mem_fun1_t<void, S, int> p1 = std::mem_fun(&S::one_arg);
    p1(&s, 1);
 
#if __cplusplus > 201100
//  auto p2 = std::mem_fun(&S::two_args); // Error: mem_fun supports only member functions
                                          // without parameters or with only one parameter.
                                          // Thus, std::mem_fn is a better alternative:
    auto p2 = std::mem_fn(&S::two_args);
    p2(s, 1, 2);
 
//  auto pd = std::mem_fun(&S::data); // Error: pointers to data members are not supported.
                                      // Use std::mem_fn instead:
    auto pd = std::mem_fn(&S::data);
    std::cout << "s.data = " << pd(s) << '\n';
#endif
}

Возможный вывод:

s.get_data(): 42
void S::no_args() const
void S::one_arg(int)
void S::two_args(int, int)
s.data = 42

См. также

mem_fn (C++11)	создает объект-функцию из указателя на член (шаблон функции)
mem_fun_ref (устарело в C++11)(удалено в C++17)	создает обертку из указателя на функцию-член, вызываемую со ссылкой на объект (шаблон функции)

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