std::function<R(Args...)>::function

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека утилит

Языковая поддержка Поддержка типов (базовые типы, RTTI) Макросы тестирования функциональности библиотеки (C++20)     Управление динамической памятью Программные утилиты Поддержка сопрограмм(C++20) Вариативные функции is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Трёхстороннее сравнение (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)     is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

Общие утилиты Дата и время Функциональные объекты Библиотека форматирования(C++20) bitset hash (C++11) Операторы отношения (устарело в C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Целочисленные функции сравнения cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)     cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Операции обмена и типа swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Общие лексические типы pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Элементарные преобразования строк to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

Объекты функции

Функции обёртки function (C++11) move_only_function (C++23) copyable_function (C++26) function_ref (C++26) mem_fn (C++11) bad_function_call (C++11)	Применение частичных функций bind_frontbind_back (C++20)(C++23) bind (C++11) is_bind_expression (C++11) is_placeholder (C++11) _1, _2, _3, ... (C++11)
Вызов функции invokeinvoke_r (C++17)(C++23) Объект идентичности функции identity (C++20)	Обёртки ссылок reference_wrapper (C++11) refcref (C++11)(C++11) unwrap_referenceunwrap_ref_decay (C++20)(C++20)
Обёртки операторов plus minus negate multiplies    divides modulus bit_and bit_or bit_not (C++14)   bit_xor equal_to not_equal_to greater less greater_equal less_equal logical_and logical_or logical_not	Прозрачные обёртки операторов plus<> (C++14) minus<> (C++14) negate<> (C++14) multiplies<> (C++14)   divides<> (C++14) modulus<> (C++14) bit_and<> (C++14) bit_or<> (C++14) bit_not<> (C++14) bit_xor<> (C++14) equal_to<> (C++14) not_equal_to<> (C++14) greater<> (C++14) less<> (C++14) greater_equal<> (C++14) less_equal<> (C++14) logical_and<> (C++14) logical_or<> (C++14) logical_not<> (C++14)
Отрицатели not_fn (C++17) Искатели default_searcher (C++17) boyer_moore_searcher (C++17) boyer_moore_horspool_searcher (C++17)	Ограниченные компараторы ranges::equal_to (C++20) ranges::not_equal_to (C++20) ranges::greater (C++20) ranges::less (C++20) ranges::greater_equal (C++20) ranges::less_equal (C++20) compare_three_way (C++20)
Старые привязки и адаптеры
unary_function (до C++17*) binary_function (до C++17*) ptr_fun (до C++17*) pointer_to_unary_function (до C++17*) pointer_to_binary_function (до C++17*) mem_fun (до C++17*) mem_fun_tmem_fun1_tconst_mem_fun_tconst_mem_fun1_t (до C++17*)(до C++17*)(до C++17*)(до C++17*) not1 (до C++20*) not2 (до C++20*)	binder1stbinder2nd (до C++17*)(до C++17*) bind1stbind2nd (до C++17*)(до C++17*) mem_fun_ref (до C++17*) mem_fun_ref_tmem_fun1_ref_tconst_mem_fun_ref_tconst_mem_fun1_ref_t (до C++17*)(до C++17*)(до C++17*)(до C++17*) unary_negate (до C++20*) binary_negate (до C++20*)

 

std::function

Функции-элементы

function::function

function::~function

function::operator=

function::swap

function::assign (до C++17)

function::operator bool

function::operator()

function::target_type

function::target

Функции, не являющиеся элементами

operator==operator!= (до C++20)

std::swap(std::function)

Вспомогательные классы

std::uses_allocator<std::function> (до C++17)

Принципы вывода(C++17)

 

function()noexcept;	(1)	(начиная с C++11)
function(std::nullptr_t)noexcept;	(2)	(начиная с C++11)
function(const function& other );	(3)	(начиная с C++11)
	(4)
function( function&& other );			(начиная с C++11) (до C++20)
function( function&& other )noexcept;			(начиная с C++20)
template<class F > function( F&& f );		(5)	(начиная с C++11)
template<class Alloc > function(std::allocator_arg_t, const Alloc& alloc )noexcept;		(6)	(начиная с C++11) (удалено в C++17)
template<class Alloc > function(std::allocator_arg_t, const Alloc& alloc,           std::nullptr_t)noexcept;		(7)	(начиная с C++11) (удалено в C++17)
template<class Alloc > function(std::allocator_arg_t, const Alloc& alloc,           const function& other );		(8)	(начиная с C++11) (удалено в C++17)
template<class Alloc > function(std::allocator_arg_t, const Alloc& alloc,           function&& other );		(9)	(начиная с C++11) (удалено в C++17)
template<class F, class Alloc > function(std::allocator_arg_t, const Alloc& alloc, F f );		(10)	(начиная с C++11) (удалено в C++17)

Создаёт std::function из различных источников.

1,2) Создаёт пустую функцию.

3,4) Копирует (3) или перемещает (4)цель объекта other в цель объекта *this. Если otherпустой, *this после вызова будет тоже пустым. Для (4), other после вызова находится в допустимом, но неопределённом состоянии.

5) Инициализирует цель с помощью std::forward<F>(f). Цель имеет тип std::decay<F>::type. Если f является нулевым указателем на функцию, нулевым указателем на элемент или пустым значением некоторой специализации std::function, *this после вызова будет пустым. Этот конструктор не участвует в разрешении перегрузки, если целевой тип не совпадает с function, а его lvalue равно Callable для типов аргументов Args... и возвращаемого типа R. Программа некорректна, если целевой тип не является копируемым или инициализация цели некорректна.

6-10) То же, что и (1-5), за исключением того, что alloc используется для выделения памяти для любых внутренних структур данных, которые может использовать function.

Когда целью является указатель на функцию или std::reference_wrapper, оптимизация малых объектов гарантируется, то есть эти цели всегда хранятся непосредственно внутри объекта std::function, динамическое размещение не происходит. Другие большие объекты могут быть созданы в динамически выделенной памяти и доступны для объекта std::function через указатель.

Параметры

other	—	объект function, используемый для инициализации *this
f	—	вызываемый объект, используемый для инициализации *this
alloc	—	Allocator, используемый для выделения внутренней памяти
Требования к типам
- std::decay<F>::type должен соответствовать требованиям Callable и CopyConstructible.
- Alloc должен соответствовать требованиям Allocator.

Исключения

3,8,9) Не генерирует исключение, если цель объекта other является указателем на функцию или std::reference_wrapper, иначе может сгенерировать std::bad_alloc или любое другое исключение, созданное конструктором, используемым для копирования или перемещения сохранённого вызываемого объекта.

4) Не генерирует исключение, если цель объекта other является указателем на функцию или std::reference_wrapper, иначе может сгенерировать std::bad_alloc или любое другое исключение, созданное конструктором, используемым для копирования или перемещения сохранённого вызываемого объекта.

(до C++20)

5,10) Не генерирует исключение, если f является указателем на функцию или std::reference_wrapper, иначе может сгенерировать std::bad_alloc или любое исключение, сгенерированное конструктором копирования сохранённого вызываемого объекта.

Примечание

Поддержка аллокатора объекта std::function была плохо определена и реализована непоследовательно. Некоторые реализации вообще не предоставляют перегрузок (6-10), некоторые предоставляют перегрузки, но игнорируют предоставленный аргумент аллокатора, а некоторые предоставляют перегрузки и используют предоставленный аллокатор для создания, но не для переназначения std::function. В результате поддержка аллокатора была удалена в C++17.

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 2132	C++11	конструктор, принимающий объект Callable, может быть неоднозначным	ограничено
LWG 2774	C++11	конструктор, принимающий Callable, выполнял дополнительное перемещение	устранено

Смотрите также

(конструктор) (C++23)

создаёт новый объект std::move_only_function (public функция-элемент std::move_only_function)