Пространства имён
Варианты
Действия

std::mem_fun

Материал из cppreference.com
< cpp‎ | utility‎ | functional
 
 
Библиотека утилит
Языковая поддержка
Поддержка типов (базовые типы, RTTI)
Макросы тестирования функциональности библиотеки (C++20)    
Управление динамической памятью
Программные утилиты
Поддержка сопрограмм (C++20)
Вариативные функции
Трёхстороннее сравнение (C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
Общие утилиты
Дата и время
Функциональные объекты
Библиотека форматирования (C++20)
(C++11)
Операторы отношения (устарело в C++20)
Целочисленные функции сравнения
(C++20)(C++20)(C++20)    
(C++20)
Операции обмена и типа
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Общие лексические типы
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
Элементарные преобразования строк
(C++17)
(C++17)
 
Объекты функции
Функции обёртки
(C++11)
(C++11)
Применение частичных функций
(C++20)(C++23)
(C++11)
Вызов функции
(C++17)(C++23)
Объект идентичности функции
(C++20)
Обёртки ссылок
(C++11)(C++11)
Прозрачные обёртки операторов
(C++14)
(C++14)
(C++14)
(C++14)  
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)

Отрицатели
(C++17)
Искатели
Ограниченные компараторы
Старые привязки и адаптеры
(до C++17*)
(до C++17*)
(до C++17*)
mem_fun
(до C++17*)
(до C++17*)(до C++17*)(до C++17*)(до C++17*)
(до C++20*)
(до C++20*)
(до C++17*)(до C++17*)
(до C++17*)(до C++17*)

(до C++17*)
(до C++17*)(до C++17*)(до C++17*)(до C++17*)
(до C++20*)
(до C++20*)
 
Определено в заголовочном файле <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 указатель на функцию-элемент для создания оболочки

[править] Возвращаемое значение

Функциональный объект, обёртывающий 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, может выдать предупреждения об "deprecated declaration", если код не скомпилирован в режиме 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); // Ошибка: mem_fun поддерживает только
                                          // функции-элементы без параметров или
                                          // только с одним параметром. Таким образом,
                                          // std::mem_fn лучшая альтернатива:
    auto p2 = std::mem_fn(&S::two_args);
    p2(s, 1, 2);
 
//  auto pd = std::mem_fun(&S::data); // Ошибка: указатели на элементы данных
                                      // не поддерживаются.
                                      // Вместо этого используйте std::mem_fn:
    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

[править] Смотрите также

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