| 1 | // Implementation of std::function -*- C++ -*- | 
|---|
| 2 |  | 
|---|
| 3 | // Copyright (C) 2004-2017 Free Software Foundation, Inc. | 
|---|
| 4 | // | 
|---|
| 5 | // This file is part of the GNU ISO C++ Library.  This library is free | 
|---|
| 6 | // software; you can redistribute it and/or modify it under the | 
|---|
| 7 | // terms of the GNU General Public License as published by the | 
|---|
| 8 | // Free Software Foundation; either version 3, or (at your option) | 
|---|
| 9 | // any later version. | 
|---|
| 10 |  | 
|---|
| 11 | // This library is distributed in the hope that it will be useful, | 
|---|
| 12 | // but WITHOUT ANY WARRANTY; without even the implied warranty of | 
|---|
| 13 | // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
|---|
| 14 | // GNU General Public License for more details. | 
|---|
| 15 |  | 
|---|
| 16 | // Under Section 7 of GPL version 3, you are granted additional | 
|---|
| 17 | // permissions described in the GCC Runtime Library Exception, version | 
|---|
| 18 | // 3.1, as published by the Free Software Foundation. | 
|---|
| 19 |  | 
|---|
| 20 | // You should have received a copy of the GNU General Public License and | 
|---|
| 21 | // a copy of the GCC Runtime Library Exception along with this program; | 
|---|
| 22 | // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see | 
|---|
| 23 | // <http://www.gnu.org/licenses/>. | 
|---|
| 24 |  | 
|---|
| 25 | /** @file include/bits/function.h | 
|---|
| 26 | *  This is an internal header file, included by other library headers. | 
|---|
| 27 | *  Do not attempt to use it directly. @headername{functional} | 
|---|
| 28 | */ | 
|---|
| 29 |  | 
|---|
| 30 | #ifndef _GLIBCXX_STD_FUNCTION_H | 
|---|
| 31 | #define _GLIBCXX_STD_FUNCTION_H 1 | 
|---|
| 32 |  | 
|---|
| 33 | #pragma GCC system_header | 
|---|
| 34 |  | 
|---|
| 35 | #if __cplusplus < 201103L | 
|---|
| 36 | # include <bits/c++0x_warning.h> | 
|---|
| 37 | #else | 
|---|
| 38 |  | 
|---|
| 39 | #if __cpp_rtti | 
|---|
| 40 | # include <typeinfo> | 
|---|
| 41 | #endif | 
|---|
| 42 | #include <bits/stl_function.h> | 
|---|
| 43 | #include <bits/invoke.h> | 
|---|
| 44 | #include <bits/refwrap.h> | 
|---|
| 45 | #include <bits/functexcept.h> | 
|---|
| 46 |  | 
|---|
| 47 | namespace std _GLIBCXX_VISIBILITY(default) | 
|---|
| 48 | { | 
|---|
| 49 | _GLIBCXX_BEGIN_NAMESPACE_VERSION | 
|---|
| 50 |  | 
|---|
| 51 | /** | 
|---|
| 52 | * Derives from @c unary_function or @c binary_function, or perhaps | 
|---|
| 53 | * nothing, depending on the number of arguments provided. The | 
|---|
| 54 | * primary template is the basis case, which derives nothing. | 
|---|
| 55 | */ | 
|---|
| 56 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 57 | struct _Maybe_unary_or_binary_function { }; | 
|---|
| 58 |  | 
|---|
| 59 | /// Derives from @c unary_function, as appropriate. | 
|---|
| 60 | template<typename _Res, typename _T1> | 
|---|
| 61 | struct _Maybe_unary_or_binary_function<_Res, _T1> | 
|---|
| 62 | : std::unary_function<_T1, _Res> { }; | 
|---|
| 63 |  | 
|---|
| 64 | /// Derives from @c binary_function, as appropriate. | 
|---|
| 65 | template<typename _Res, typename _T1, typename _T2> | 
|---|
| 66 | struct _Maybe_unary_or_binary_function<_Res, _T1, _T2> | 
|---|
| 67 | : std::binary_function<_T1, _T2, _Res> { }; | 
|---|
| 68 |  | 
|---|
| 69 |  | 
|---|
| 70 | /** | 
|---|
| 71 | *  @brief Exception class thrown when class template function's | 
|---|
| 72 | *  operator() is called with an empty target. | 
|---|
| 73 | *  @ingroup exceptions | 
|---|
| 74 | */ | 
|---|
| 75 | class bad_function_call : public std::exception | 
|---|
| 76 | { | 
|---|
| 77 | public: | 
|---|
| 78 | virtual ~bad_function_call() noexcept; | 
|---|
| 79 |  | 
|---|
| 80 | const char* what() const noexcept; | 
|---|
| 81 | }; | 
|---|
| 82 |  | 
|---|
| 83 | /** | 
|---|
| 84 | *  Trait identifying "location-invariant" types, meaning that the | 
|---|
| 85 | *  address of the object (or any of its members) will not escape. | 
|---|
| 86 | *  Trivially copyable types are location-invariant and users can | 
|---|
| 87 | *  specialize this trait for other types. | 
|---|
| 88 | */ | 
|---|
| 89 | template<typename _Tp> | 
|---|
| 90 | struct __is_location_invariant | 
|---|
| 91 | : is_trivially_copyable<_Tp>::type | 
|---|
| 92 | { }; | 
|---|
| 93 |  | 
|---|
| 94 | class _Undefined_class; | 
|---|
| 95 |  | 
|---|
| 96 | union _Nocopy_types | 
|---|
| 97 | { | 
|---|
| 98 | void*       _M_object; | 
|---|
| 99 | const void* _M_const_object; | 
|---|
| 100 | void (*_M_function_pointer)(); | 
|---|
| 101 | void (_Undefined_class::*_M_member_pointer)(); | 
|---|
| 102 | }; | 
|---|
| 103 |  | 
|---|
| 104 | union [[gnu::may_alias]] _Any_data | 
|---|
| 105 | { | 
|---|
| 106 | void*       _M_access()       { return &_M_pod_data[0]; } | 
|---|
| 107 | const void* _M_access() const { return &_M_pod_data[0]; } | 
|---|
| 108 |  | 
|---|
| 109 | template<typename _Tp> | 
|---|
| 110 | _Tp& | 
|---|
| 111 | _M_access() | 
|---|
| 112 | { return *static_cast<_Tp*>(_M_access()); } | 
|---|
| 113 |  | 
|---|
| 114 | template<typename _Tp> | 
|---|
| 115 | const _Tp& | 
|---|
| 116 | _M_access() const | 
|---|
| 117 | { return *static_cast<const _Tp*>(_M_access()); } | 
|---|
| 118 |  | 
|---|
| 119 | _Nocopy_types _M_unused; | 
|---|
| 120 | char _M_pod_data[sizeof(_Nocopy_types)]; | 
|---|
| 121 | }; | 
|---|
| 122 |  | 
|---|
| 123 | enum _Manager_operation | 
|---|
| 124 | { | 
|---|
| 125 | __get_type_info, | 
|---|
| 126 | __get_functor_ptr, | 
|---|
| 127 | __clone_functor, | 
|---|
| 128 | __destroy_functor | 
|---|
| 129 | }; | 
|---|
| 130 |  | 
|---|
| 131 | // Simple type wrapper that helps avoid annoying const problems | 
|---|
| 132 | // when casting between void pointers and pointers-to-pointers. | 
|---|
| 133 | template<typename _Tp> | 
|---|
| 134 | struct _Simple_type_wrapper | 
|---|
| 135 | { | 
|---|
| 136 | _Simple_type_wrapper(_Tp __value) : __value(__value) { } | 
|---|
| 137 |  | 
|---|
| 138 | _Tp __value; | 
|---|
| 139 | }; | 
|---|
| 140 |  | 
|---|
| 141 | template<typename _Tp> | 
|---|
| 142 | struct __is_location_invariant<_Simple_type_wrapper<_Tp> > | 
|---|
| 143 | : __is_location_invariant<_Tp> | 
|---|
| 144 | { }; | 
|---|
| 145 |  | 
|---|
| 146 | template<typename _Signature> | 
|---|
| 147 | class function; | 
|---|
| 148 |  | 
|---|
| 149 | /// Base class of all polymorphic function object wrappers. | 
|---|
| 150 | class _Function_base | 
|---|
| 151 | { | 
|---|
| 152 | public: | 
|---|
| 153 | static const std::size_t _M_max_size = sizeof(_Nocopy_types); | 
|---|
| 154 | static const std::size_t _M_max_align = __alignof__(_Nocopy_types); | 
|---|
| 155 |  | 
|---|
| 156 | template<typename _Functor> | 
|---|
| 157 | class _Base_manager | 
|---|
| 158 | { | 
|---|
| 159 | protected: | 
|---|
| 160 | static const bool __stored_locally = | 
|---|
| 161 | (__is_location_invariant<_Functor>::value | 
|---|
| 162 | && sizeof(_Functor) <= _M_max_size | 
|---|
| 163 | && __alignof__(_Functor) <= _M_max_align | 
|---|
| 164 | && (_M_max_align % __alignof__(_Functor) == 0)); | 
|---|
| 165 |  | 
|---|
| 166 | typedef integral_constant<bool, __stored_locally> _Local_storage; | 
|---|
| 167 |  | 
|---|
| 168 | // Retrieve a pointer to the function object | 
|---|
| 169 | static _Functor* | 
|---|
| 170 | _M_get_pointer(const _Any_data& __source) | 
|---|
| 171 | { | 
|---|
| 172 | const _Functor* __ptr = | 
|---|
| 173 | __stored_locally? std::__addressof(__source._M_access<_Functor>()) | 
|---|
| 174 | /* have stored a pointer */ : __source._M_access<_Functor*>(); | 
|---|
| 175 | return const_cast<_Functor*>(__ptr); | 
|---|
| 176 | } | 
|---|
| 177 |  | 
|---|
| 178 | // Clone a location-invariant function object that fits within | 
|---|
| 179 | // an _Any_data structure. | 
|---|
| 180 | static void | 
|---|
| 181 | _M_clone(_Any_data& __dest, const _Any_data& __source, true_type) | 
|---|
| 182 | { | 
|---|
| 183 | ::new (__dest._M_access()) _Functor(__source._M_access<_Functor>()); | 
|---|
| 184 | } | 
|---|
| 185 |  | 
|---|
| 186 | // Clone a function object that is not location-invariant or | 
|---|
| 187 | // that cannot fit into an _Any_data structure. | 
|---|
| 188 | static void | 
|---|
| 189 | _M_clone(_Any_data& __dest, const _Any_data& __source, false_type) | 
|---|
| 190 | { | 
|---|
| 191 | __dest._M_access<_Functor*>() = | 
|---|
| 192 | new _Functor(*__source._M_access<_Functor*>()); | 
|---|
| 193 | } | 
|---|
| 194 |  | 
|---|
| 195 | // Destroying a location-invariant object may still require | 
|---|
| 196 | // destruction. | 
|---|
| 197 | static void | 
|---|
| 198 | _M_destroy(_Any_data& __victim, true_type) | 
|---|
| 199 | { | 
|---|
| 200 | __victim._M_access<_Functor>().~_Functor(); | 
|---|
| 201 | } | 
|---|
| 202 |  | 
|---|
| 203 | // Destroying an object located on the heap. | 
|---|
| 204 | static void | 
|---|
| 205 | _M_destroy(_Any_data& __victim, false_type) | 
|---|
| 206 | { | 
|---|
| 207 | delete __victim._M_access<_Functor*>(); | 
|---|
| 208 | } | 
|---|
| 209 |  | 
|---|
| 210 | public: | 
|---|
| 211 | static bool | 
|---|
| 212 | _M_manager(_Any_data& __dest, const _Any_data& __source, | 
|---|
| 213 | _Manager_operation __op) | 
|---|
| 214 | { | 
|---|
| 215 | switch (__op) | 
|---|
| 216 | { | 
|---|
| 217 | #if __cpp_rtti | 
|---|
| 218 | case __get_type_info: | 
|---|
| 219 | __dest._M_access<const type_info*>() = &typeid(_Functor); | 
|---|
| 220 | break; | 
|---|
| 221 | #endif | 
|---|
| 222 | case __get_functor_ptr: | 
|---|
| 223 | __dest._M_access<_Functor*>() = _M_get_pointer(__source); | 
|---|
| 224 | break; | 
|---|
| 225 |  | 
|---|
| 226 | case __clone_functor: | 
|---|
| 227 | _M_clone(__dest, __source, _Local_storage()); | 
|---|
| 228 | break; | 
|---|
| 229 |  | 
|---|
| 230 | case __destroy_functor: | 
|---|
| 231 | _M_destroy(__dest, _Local_storage()); | 
|---|
| 232 | break; | 
|---|
| 233 | } | 
|---|
| 234 | return false; | 
|---|
| 235 | } | 
|---|
| 236 |  | 
|---|
| 237 | static void | 
|---|
| 238 | _M_init_functor(_Any_data& __functor, _Functor&& __f) | 
|---|
| 239 | { _M_init_functor(__functor, std::move(__f), _Local_storage()); } | 
|---|
| 240 |  | 
|---|
| 241 | template<typename _Signature> | 
|---|
| 242 | static bool | 
|---|
| 243 | _M_not_empty_function(const function<_Signature>& __f) | 
|---|
| 244 | { return static_cast<bool>(__f); } | 
|---|
| 245 |  | 
|---|
| 246 | template<typename _Tp> | 
|---|
| 247 | static bool | 
|---|
| 248 | _M_not_empty_function(_Tp* __fp) | 
|---|
| 249 | { return __fp != nullptr; } | 
|---|
| 250 |  | 
|---|
| 251 | template<typename _Class, typename _Tp> | 
|---|
| 252 | static bool | 
|---|
| 253 | _M_not_empty_function(_Tp _Class::* __mp) | 
|---|
| 254 | { return __mp != nullptr; } | 
|---|
| 255 |  | 
|---|
| 256 | template<typename _Tp> | 
|---|
| 257 | static bool | 
|---|
| 258 | _M_not_empty_function(const _Tp&) | 
|---|
| 259 | { return true; } | 
|---|
| 260 |  | 
|---|
| 261 | private: | 
|---|
| 262 | static void | 
|---|
| 263 | _M_init_functor(_Any_data& __functor, _Functor&& __f, true_type) | 
|---|
| 264 | { ::new (__functor._M_access()) _Functor(std::move(__f)); } | 
|---|
| 265 |  | 
|---|
| 266 | static void | 
|---|
| 267 | _M_init_functor(_Any_data& __functor, _Functor&& __f, false_type) | 
|---|
| 268 | { __functor._M_access<_Functor*>() = new _Functor(std::move(__f)); } | 
|---|
| 269 | }; | 
|---|
| 270 |  | 
|---|
| 271 | _Function_base() : _M_manager(nullptr) { } | 
|---|
| 272 |  | 
|---|
| 273 | ~_Function_base() | 
|---|
| 274 | { | 
|---|
| 275 | if (_M_manager) | 
|---|
| 276 | _M_manager(_M_functor, _M_functor, __destroy_functor); | 
|---|
| 277 | } | 
|---|
| 278 |  | 
|---|
| 279 | bool _M_empty() const { return !_M_manager; } | 
|---|
| 280 |  | 
|---|
| 281 | typedef bool (*_Manager_type)(_Any_data&, const _Any_data&, | 
|---|
| 282 | _Manager_operation); | 
|---|
| 283 |  | 
|---|
| 284 | _Any_data     _M_functor; | 
|---|
| 285 | _Manager_type _M_manager; | 
|---|
| 286 | }; | 
|---|
| 287 |  | 
|---|
| 288 | template<typename _Signature, typename _Functor> | 
|---|
| 289 | class _Function_handler; | 
|---|
| 290 |  | 
|---|
| 291 | template<typename _Res, typename _Functor, typename... _ArgTypes> | 
|---|
| 292 | class _Function_handler<_Res(_ArgTypes...), _Functor> | 
|---|
| 293 | : public _Function_base::_Base_manager<_Functor> | 
|---|
| 294 | { | 
|---|
| 295 | typedef _Function_base::_Base_manager<_Functor> _Base; | 
|---|
| 296 |  | 
|---|
| 297 | public: | 
|---|
| 298 | static _Res | 
|---|
| 299 | _M_invoke(const _Any_data& __functor, _ArgTypes&&... __args) | 
|---|
| 300 | { | 
|---|
| 301 | return (*_Base::_M_get_pointer(__functor))( | 
|---|
| 302 | std::forward<_ArgTypes>(__args)...); | 
|---|
| 303 | } | 
|---|
| 304 | }; | 
|---|
| 305 |  | 
|---|
| 306 | template<typename _Functor, typename... _ArgTypes> | 
|---|
| 307 | class _Function_handler<void(_ArgTypes...), _Functor> | 
|---|
| 308 | : public _Function_base::_Base_manager<_Functor> | 
|---|
| 309 | { | 
|---|
| 310 | typedef _Function_base::_Base_manager<_Functor> _Base; | 
|---|
| 311 |  | 
|---|
| 312 | public: | 
|---|
| 313 | static void | 
|---|
| 314 | _M_invoke(const _Any_data& __functor, _ArgTypes&&... __args) | 
|---|
| 315 | { | 
|---|
| 316 | (*_Base::_M_get_pointer(__functor))( | 
|---|
| 317 | std::forward<_ArgTypes>(__args)...); | 
|---|
| 318 | } | 
|---|
| 319 | }; | 
|---|
| 320 |  | 
|---|
| 321 | template<typename _Class, typename _Member, typename _Res, | 
|---|
| 322 | typename... _ArgTypes> | 
|---|
| 323 | class _Function_handler<_Res(_ArgTypes...), _Member _Class::*> | 
|---|
| 324 | : public _Function_handler<void(_ArgTypes...), _Member _Class::*> | 
|---|
| 325 | { | 
|---|
| 326 | typedef _Function_handler<void(_ArgTypes...), _Member _Class::*> | 
|---|
| 327 | _Base; | 
|---|
| 328 |  | 
|---|
| 329 | public: | 
|---|
| 330 | static _Res | 
|---|
| 331 | _M_invoke(const _Any_data& __functor, _ArgTypes&&... __args) | 
|---|
| 332 | { | 
|---|
| 333 | return std::__invoke(_Base::_M_get_pointer(__functor)->__value, | 
|---|
| 334 | std::forward<_ArgTypes>(__args)...); | 
|---|
| 335 | } | 
|---|
| 336 | }; | 
|---|
| 337 |  | 
|---|
| 338 | template<typename _Class, typename _Member, typename... _ArgTypes> | 
|---|
| 339 | class _Function_handler<void(_ArgTypes...), _Member _Class::*> | 
|---|
| 340 | : public _Function_base::_Base_manager< | 
|---|
| 341 | _Simple_type_wrapper< _Member _Class::* > > | 
|---|
| 342 | { | 
|---|
| 343 | typedef _Member _Class::* _Functor; | 
|---|
| 344 | typedef _Simple_type_wrapper<_Functor> _Wrapper; | 
|---|
| 345 | typedef _Function_base::_Base_manager<_Wrapper> _Base; | 
|---|
| 346 |  | 
|---|
| 347 | public: | 
|---|
| 348 | static bool | 
|---|
| 349 | _M_manager(_Any_data& __dest, const _Any_data& __source, | 
|---|
| 350 | _Manager_operation __op) | 
|---|
| 351 | { | 
|---|
| 352 | switch (__op) | 
|---|
| 353 | { | 
|---|
| 354 | #if __cpp_rtti | 
|---|
| 355 | case __get_type_info: | 
|---|
| 356 | __dest._M_access<const type_info*>() = &typeid(_Functor); | 
|---|
| 357 | break; | 
|---|
| 358 | #endif | 
|---|
| 359 | case __get_functor_ptr: | 
|---|
| 360 | __dest._M_access<_Functor*>() = | 
|---|
| 361 | &_Base::_M_get_pointer(__source)->__value; | 
|---|
| 362 | break; | 
|---|
| 363 |  | 
|---|
| 364 | default: | 
|---|
| 365 | _Base::_M_manager(__dest, __source, __op); | 
|---|
| 366 | } | 
|---|
| 367 | return false; | 
|---|
| 368 | } | 
|---|
| 369 |  | 
|---|
| 370 | static void | 
|---|
| 371 | _M_invoke(const _Any_data& __functor, _ArgTypes&&... __args) | 
|---|
| 372 | { | 
|---|
| 373 | std::__invoke(_Base::_M_get_pointer(__functor)->__value, | 
|---|
| 374 | std::forward<_ArgTypes>(__args)...); | 
|---|
| 375 | } | 
|---|
| 376 | }; | 
|---|
| 377 |  | 
|---|
| 378 | template<typename _From, typename _To> | 
|---|
| 379 | using __check_func_return_type | 
|---|
| 380 | = __or_<is_void<_To>, is_same<_From, _To>, is_convertible<_From, _To>>; | 
|---|
| 381 |  | 
|---|
| 382 | /** | 
|---|
| 383 | *  @brief Primary class template for std::function. | 
|---|
| 384 | *  @ingroup functors | 
|---|
| 385 | * | 
|---|
| 386 | *  Polymorphic function wrapper. | 
|---|
| 387 | */ | 
|---|
| 388 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 389 | class function<_Res(_ArgTypes...)> | 
|---|
| 390 | : public _Maybe_unary_or_binary_function<_Res, _ArgTypes...>, | 
|---|
| 391 | private _Function_base | 
|---|
| 392 | { | 
|---|
| 393 | template<typename _Func, | 
|---|
| 394 | typename _Res2 = typename result_of<_Func&(_ArgTypes...)>::type> | 
|---|
| 395 | struct _Callable : __check_func_return_type<_Res2, _Res> { }; | 
|---|
| 396 |  | 
|---|
| 397 | // Used so the return type convertibility checks aren't done when | 
|---|
| 398 | // performing overload resolution for copy construction/assignment. | 
|---|
| 399 | template<typename _Tp> | 
|---|
| 400 | struct _Callable<function, _Tp> : false_type { }; | 
|---|
| 401 |  | 
|---|
| 402 | template<typename _Cond, typename _Tp> | 
|---|
| 403 | using _Requires = typename enable_if<_Cond::value, _Tp>::type; | 
|---|
| 404 |  | 
|---|
| 405 | public: | 
|---|
| 406 | typedef _Res result_type; | 
|---|
| 407 |  | 
|---|
| 408 | // [3.7.2.1] construct/copy/destroy | 
|---|
| 409 |  | 
|---|
| 410 | /** | 
|---|
| 411 | *  @brief Default construct creates an empty function call wrapper. | 
|---|
| 412 | *  @post @c !(bool)*this | 
|---|
| 413 | */ | 
|---|
| 414 | function() noexcept | 
|---|
| 415 | : _Function_base() { } | 
|---|
| 416 |  | 
|---|
| 417 | /** | 
|---|
| 418 | *  @brief Creates an empty function call wrapper. | 
|---|
| 419 | *  @post @c !(bool)*this | 
|---|
| 420 | */ | 
|---|
| 421 | function(nullptr_t) noexcept | 
|---|
| 422 | : _Function_base() { } | 
|---|
| 423 |  | 
|---|
| 424 | /** | 
|---|
| 425 | *  @brief %Function copy constructor. | 
|---|
| 426 | *  @param __x A %function object with identical call signature. | 
|---|
| 427 | *  @post @c bool(*this) == bool(__x) | 
|---|
| 428 | * | 
|---|
| 429 | *  The newly-created %function contains a copy of the target of @a | 
|---|
| 430 | *  __x (if it has one). | 
|---|
| 431 | */ | 
|---|
| 432 | function(const function& __x); | 
|---|
| 433 |  | 
|---|
| 434 | /** | 
|---|
| 435 | *  @brief %Function move constructor. | 
|---|
| 436 | *  @param __x A %function object rvalue with identical call signature. | 
|---|
| 437 | * | 
|---|
| 438 | *  The newly-created %function contains the target of @a __x | 
|---|
| 439 | *  (if it has one). | 
|---|
| 440 | */ | 
|---|
| 441 | function(function&& __x) noexcept : _Function_base() | 
|---|
| 442 | { | 
|---|
| 443 | __x.swap(*this); | 
|---|
| 444 | } | 
|---|
| 445 |  | 
|---|
| 446 | /** | 
|---|
| 447 | *  @brief Builds a %function that targets a copy of the incoming | 
|---|
| 448 | *  function object. | 
|---|
| 449 | *  @param __f A %function object that is callable with parameters of | 
|---|
| 450 | *  type @c T1, @c T2, ..., @c TN and returns a value convertible | 
|---|
| 451 | *  to @c Res. | 
|---|
| 452 | * | 
|---|
| 453 | *  The newly-created %function object will target a copy of | 
|---|
| 454 | *  @a __f. If @a __f is @c reference_wrapper<F>, then this function | 
|---|
| 455 | *  object will contain a reference to the function object @c | 
|---|
| 456 | *  __f.get(). If @a __f is a NULL function pointer or NULL | 
|---|
| 457 | *  pointer-to-member, the newly-created object will be empty. | 
|---|
| 458 | * | 
|---|
| 459 | *  If @a __f is a non-NULL function pointer or an object of type @c | 
|---|
| 460 | *  reference_wrapper<F>, this function will not throw. | 
|---|
| 461 | */ | 
|---|
| 462 | template<typename _Functor, | 
|---|
| 463 | typename = _Requires<__not_<is_same<_Functor, function>>, void>, | 
|---|
| 464 | typename = _Requires<_Callable<_Functor>, void>> | 
|---|
| 465 | function(_Functor); | 
|---|
| 466 |  | 
|---|
| 467 | /** | 
|---|
| 468 | *  @brief %Function assignment operator. | 
|---|
| 469 | *  @param __x A %function with identical call signature. | 
|---|
| 470 | *  @post @c (bool)*this == (bool)x | 
|---|
| 471 | *  @returns @c *this | 
|---|
| 472 | * | 
|---|
| 473 | *  The target of @a __x is copied to @c *this. If @a __x has no | 
|---|
| 474 | *  target, then @c *this will be empty. | 
|---|
| 475 | * | 
|---|
| 476 | *  If @a __x targets a function pointer or a reference to a function | 
|---|
| 477 | *  object, then this operation will not throw an %exception. | 
|---|
| 478 | */ | 
|---|
| 479 | function& | 
|---|
| 480 | operator=(const function& __x) | 
|---|
| 481 | { | 
|---|
| 482 | function(__x).swap(*this); | 
|---|
| 483 | return *this; | 
|---|
| 484 | } | 
|---|
| 485 |  | 
|---|
| 486 | /** | 
|---|
| 487 | *  @brief %Function move-assignment operator. | 
|---|
| 488 | *  @param __x A %function rvalue with identical call signature. | 
|---|
| 489 | *  @returns @c *this | 
|---|
| 490 | * | 
|---|
| 491 | *  The target of @a __x is moved to @c *this. If @a __x has no | 
|---|
| 492 | *  target, then @c *this will be empty. | 
|---|
| 493 | * | 
|---|
| 494 | *  If @a __x targets a function pointer or a reference to a function | 
|---|
| 495 | *  object, then this operation will not throw an %exception. | 
|---|
| 496 | */ | 
|---|
| 497 | function& | 
|---|
| 498 | operator=(function&& __x) noexcept | 
|---|
| 499 | { | 
|---|
| 500 | function(std::move(__x)).swap(*this); | 
|---|
| 501 | return *this; | 
|---|
| 502 | } | 
|---|
| 503 |  | 
|---|
| 504 | /** | 
|---|
| 505 | *  @brief %Function assignment to zero. | 
|---|
| 506 | *  @post @c !(bool)*this | 
|---|
| 507 | *  @returns @c *this | 
|---|
| 508 | * | 
|---|
| 509 | *  The target of @c *this is deallocated, leaving it empty. | 
|---|
| 510 | */ | 
|---|
| 511 | function& | 
|---|
| 512 | operator=(nullptr_t) noexcept | 
|---|
| 513 | { | 
|---|
| 514 | if (_M_manager) | 
|---|
| 515 | { | 
|---|
| 516 | _M_manager(_M_functor, _M_functor, __destroy_functor); | 
|---|
| 517 | _M_manager = nullptr; | 
|---|
| 518 | _M_invoker = nullptr; | 
|---|
| 519 | } | 
|---|
| 520 | return *this; | 
|---|
| 521 | } | 
|---|
| 522 |  | 
|---|
| 523 | /** | 
|---|
| 524 | *  @brief %Function assignment to a new target. | 
|---|
| 525 | *  @param __f A %function object that is callable with parameters of | 
|---|
| 526 | *  type @c T1, @c T2, ..., @c TN and returns a value convertible | 
|---|
| 527 | *  to @c Res. | 
|---|
| 528 | *  @return @c *this | 
|---|
| 529 | * | 
|---|
| 530 | *  This  %function object wrapper will target a copy of @a | 
|---|
| 531 | *  __f. If @a __f is @c reference_wrapper<F>, then this function | 
|---|
| 532 | *  object will contain a reference to the function object @c | 
|---|
| 533 | *  __f.get(). If @a __f is a NULL function pointer or NULL | 
|---|
| 534 | *  pointer-to-member, @c this object will be empty. | 
|---|
| 535 | * | 
|---|
| 536 | *  If @a __f is a non-NULL function pointer or an object of type @c | 
|---|
| 537 | *  reference_wrapper<F>, this function will not throw. | 
|---|
| 538 | */ | 
|---|
| 539 | template<typename _Functor> | 
|---|
| 540 | _Requires<_Callable<typename decay<_Functor>::type>, function&> | 
|---|
| 541 | operator=(_Functor&& __f) | 
|---|
| 542 | { | 
|---|
| 543 | function(std::forward<_Functor>(__f)).swap(*this); | 
|---|
| 544 | return *this; | 
|---|
| 545 | } | 
|---|
| 546 |  | 
|---|
| 547 | /// @overload | 
|---|
| 548 | template<typename _Functor> | 
|---|
| 549 | function& | 
|---|
| 550 | operator=(reference_wrapper<_Functor> __f) noexcept | 
|---|
| 551 | { | 
|---|
| 552 | function(__f).swap(*this); | 
|---|
| 553 | return *this; | 
|---|
| 554 | } | 
|---|
| 555 |  | 
|---|
| 556 | // [3.7.2.2] function modifiers | 
|---|
| 557 |  | 
|---|
| 558 | /** | 
|---|
| 559 | *  @brief Swap the targets of two %function objects. | 
|---|
| 560 | *  @param __x A %function with identical call signature. | 
|---|
| 561 | * | 
|---|
| 562 | *  Swap the targets of @c this function object and @a __f. This | 
|---|
| 563 | *  function will not throw an %exception. | 
|---|
| 564 | */ | 
|---|
| 565 | void swap(function& __x) noexcept | 
|---|
| 566 | { | 
|---|
| 567 | std::swap(_M_functor, __x._M_functor); | 
|---|
| 568 | std::swap(_M_manager, __x._M_manager); | 
|---|
| 569 | std::swap(_M_invoker, __x._M_invoker); | 
|---|
| 570 | } | 
|---|
| 571 |  | 
|---|
| 572 | // [3.7.2.3] function capacity | 
|---|
| 573 |  | 
|---|
| 574 | /** | 
|---|
| 575 | *  @brief Determine if the %function wrapper has a target. | 
|---|
| 576 | * | 
|---|
| 577 | *  @return @c true when this %function object contains a target, | 
|---|
| 578 | *  or @c false when it is empty. | 
|---|
| 579 | * | 
|---|
| 580 | *  This function will not throw an %exception. | 
|---|
| 581 | */ | 
|---|
| 582 | explicit operator bool() const noexcept | 
|---|
| 583 | { return !_M_empty(); } | 
|---|
| 584 |  | 
|---|
| 585 | // [3.7.2.4] function invocation | 
|---|
| 586 |  | 
|---|
| 587 | /** | 
|---|
| 588 | *  @brief Invokes the function targeted by @c *this. | 
|---|
| 589 | *  @returns the result of the target. | 
|---|
| 590 | *  @throws bad_function_call when @c !(bool)*this | 
|---|
| 591 | * | 
|---|
| 592 | *  The function call operator invokes the target function object | 
|---|
| 593 | *  stored by @c this. | 
|---|
| 594 | */ | 
|---|
| 595 | _Res operator()(_ArgTypes... __args) const; | 
|---|
| 596 |  | 
|---|
| 597 | #if __cpp_rtti | 
|---|
| 598 | // [3.7.2.5] function target access | 
|---|
| 599 | /** | 
|---|
| 600 | *  @brief Determine the type of the target of this function object | 
|---|
| 601 | *  wrapper. | 
|---|
| 602 | * | 
|---|
| 603 | *  @returns the type identifier of the target function object, or | 
|---|
| 604 | *  @c typeid(void) if @c !(bool)*this. | 
|---|
| 605 | * | 
|---|
| 606 | *  This function will not throw an %exception. | 
|---|
| 607 | */ | 
|---|
| 608 | const type_info& target_type() const noexcept; | 
|---|
| 609 |  | 
|---|
| 610 | /** | 
|---|
| 611 | *  @brief Access the stored target function object. | 
|---|
| 612 | * | 
|---|
| 613 | *  @return Returns a pointer to the stored target function object, | 
|---|
| 614 | *  if @c typeid(_Functor).equals(target_type()); otherwise, a NULL | 
|---|
| 615 | *  pointer. | 
|---|
| 616 | * | 
|---|
| 617 | * This function does not throw exceptions. | 
|---|
| 618 | * | 
|---|
| 619 | * @{ | 
|---|
| 620 | */ | 
|---|
| 621 | template<typename _Functor>       _Functor* target() noexcept; | 
|---|
| 622 |  | 
|---|
| 623 | template<typename _Functor> const _Functor* target() const noexcept; | 
|---|
| 624 | // @} | 
|---|
| 625 | #endif | 
|---|
| 626 |  | 
|---|
| 627 | private: | 
|---|
| 628 | using _Invoker_type = _Res (*)(const _Any_data&, _ArgTypes&&...); | 
|---|
| 629 | _Invoker_type _M_invoker; | 
|---|
| 630 | }; | 
|---|
| 631 |  | 
|---|
| 632 | #if __cpp_deduction_guides >= 201606 | 
|---|
| 633 | template<typename> | 
|---|
| 634 | struct __function_guide_helper | 
|---|
| 635 | { }; | 
|---|
| 636 |  | 
|---|
| 637 | template<typename _Res, typename _Tp, bool _Nx, typename... _Args> | 
|---|
| 638 | struct __function_guide_helper< | 
|---|
| 639 | _Res (_Tp::*) (_Args...) noexcept(_Nx) | 
|---|
| 640 | > | 
|---|
| 641 | { using type = _Res(_Args...); }; | 
|---|
| 642 |  | 
|---|
| 643 | template<typename _Res, typename _Tp, bool _Nx, typename... _Args> | 
|---|
| 644 | struct __function_guide_helper< | 
|---|
| 645 | _Res (_Tp::*) (_Args...) & noexcept(_Nx) | 
|---|
| 646 | > | 
|---|
| 647 | { using type = _Res(_Args...); }; | 
|---|
| 648 |  | 
|---|
| 649 | template<typename _Res, typename _Tp, bool _Nx, typename... _Args> | 
|---|
| 650 | struct __function_guide_helper< | 
|---|
| 651 | _Res (_Tp::*) (_Args...) const noexcept(_Nx) | 
|---|
| 652 | > | 
|---|
| 653 | { using type = _Res(_Args...); }; | 
|---|
| 654 |  | 
|---|
| 655 | template<typename _Res, typename _Tp, bool _Nx, typename... _Args> | 
|---|
| 656 | struct __function_guide_helper< | 
|---|
| 657 | _Res (_Tp::*) (_Args...) const & noexcept(_Nx) | 
|---|
| 658 | > | 
|---|
| 659 | { using type = _Res(_Args...); }; | 
|---|
| 660 |  | 
|---|
| 661 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 662 | function(_Res(*)(_ArgTypes...)) -> function<_Res(_ArgTypes...)>; | 
|---|
| 663 |  | 
|---|
| 664 | template<typename _Functor, typename _Signature = typename | 
|---|
| 665 | __function_guide_helper<decltype(&_Functor::operator())>::type> | 
|---|
| 666 | function(_Functor) -> function<_Signature>; | 
|---|
| 667 | #endif | 
|---|
| 668 |  | 
|---|
| 669 | // Out-of-line member definitions. | 
|---|
| 670 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 671 | function<_Res(_ArgTypes...)>:: | 
|---|
| 672 | function(const function& __x) | 
|---|
| 673 | : _Function_base() | 
|---|
| 674 | { | 
|---|
| 675 | if (static_cast<bool>(__x)) | 
|---|
| 676 | { | 
|---|
| 677 | __x._M_manager(_M_functor, __x._M_functor, __clone_functor); | 
|---|
| 678 | _M_invoker = __x._M_invoker; | 
|---|
| 679 | _M_manager = __x._M_manager; | 
|---|
| 680 | } | 
|---|
| 681 | } | 
|---|
| 682 |  | 
|---|
| 683 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 684 | template<typename _Functor, typename, typename> | 
|---|
| 685 | function<_Res(_ArgTypes...)>:: | 
|---|
| 686 | function(_Functor __f) | 
|---|
| 687 | : _Function_base() | 
|---|
| 688 | { | 
|---|
| 689 | typedef _Function_handler<_Res(_ArgTypes...), _Functor> _My_handler; | 
|---|
| 690 |  | 
|---|
| 691 | if (_My_handler::_M_not_empty_function(__f)) | 
|---|
| 692 | { | 
|---|
| 693 | _My_handler::_M_init_functor(_M_functor, std::move(__f)); | 
|---|
| 694 | _M_invoker = &_My_handler::_M_invoke; | 
|---|
| 695 | _M_manager = &_My_handler::_M_manager; | 
|---|
| 696 | } | 
|---|
| 697 | } | 
|---|
| 698 |  | 
|---|
| 699 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 700 | _Res | 
|---|
| 701 | function<_Res(_ArgTypes...)>:: | 
|---|
| 702 | operator()(_ArgTypes... __args) const | 
|---|
| 703 | { | 
|---|
| 704 | if (_M_empty()) | 
|---|
| 705 | __throw_bad_function_call(); | 
|---|
| 706 | return _M_invoker(_M_functor, std::forward<_ArgTypes>(__args)...); | 
|---|
| 707 | } | 
|---|
| 708 |  | 
|---|
| 709 | #if __cpp_rtti | 
|---|
| 710 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 711 | const type_info& | 
|---|
| 712 | function<_Res(_ArgTypes...)>:: | 
|---|
| 713 | target_type() const noexcept | 
|---|
| 714 | { | 
|---|
| 715 | if (_M_manager) | 
|---|
| 716 | { | 
|---|
| 717 | _Any_data __typeinfo_result; | 
|---|
| 718 | _M_manager(__typeinfo_result, _M_functor, __get_type_info); | 
|---|
| 719 | return *__typeinfo_result._M_access<const type_info*>(); | 
|---|
| 720 | } | 
|---|
| 721 | else | 
|---|
| 722 | return typeid(void); | 
|---|
| 723 | } | 
|---|
| 724 |  | 
|---|
| 725 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 726 | template<typename _Functor> | 
|---|
| 727 | _Functor* | 
|---|
| 728 | function<_Res(_ArgTypes...)>:: | 
|---|
| 729 | target() noexcept | 
|---|
| 730 | { | 
|---|
| 731 | const function* __const_this = this; | 
|---|
| 732 | const _Functor* __func = __const_this->template target<_Functor>(); | 
|---|
| 733 | return const_cast<_Functor*>(__func); | 
|---|
| 734 | } | 
|---|
| 735 |  | 
|---|
| 736 | template<typename _Res, typename... _ArgTypes> | 
|---|
| 737 | template<typename _Functor> | 
|---|
| 738 | const _Functor* | 
|---|
| 739 | function<_Res(_ArgTypes...)>:: | 
|---|
| 740 | target() const noexcept | 
|---|
| 741 | { | 
|---|
| 742 | if (typeid(_Functor) == target_type() && _M_manager) | 
|---|
| 743 | { | 
|---|
| 744 | _Any_data __ptr; | 
|---|
| 745 | _M_manager(__ptr, _M_functor, __get_functor_ptr); | 
|---|
| 746 | return __ptr._M_access<const _Functor*>(); | 
|---|
| 747 | } | 
|---|
| 748 | else | 
|---|
| 749 | return nullptr; | 
|---|
| 750 | } | 
|---|
| 751 | #endif | 
|---|
| 752 |  | 
|---|
| 753 | // [20.7.15.2.6] null pointer comparisons | 
|---|
| 754 |  | 
|---|
| 755 | /** | 
|---|
| 756 | *  @brief Compares a polymorphic function object wrapper against 0 | 
|---|
| 757 | *  (the NULL pointer). | 
|---|
| 758 | *  @returns @c true if the wrapper has no target, @c false otherwise | 
|---|
| 759 | * | 
|---|
| 760 | *  This function will not throw an %exception. | 
|---|
| 761 | */ | 
|---|
| 762 | template<typename _Res, typename... _Args> | 
|---|
| 763 | inline bool | 
|---|
| 764 | operator==(const function<_Res(_Args...)>& __f, nullptr_t) noexcept | 
|---|
| 765 | { return !static_cast<bool>(__f); } | 
|---|
| 766 |  | 
|---|
| 767 | /// @overload | 
|---|
| 768 | template<typename _Res, typename... _Args> | 
|---|
| 769 | inline bool | 
|---|
| 770 | operator==(nullptr_t, const function<_Res(_Args...)>& __f) noexcept | 
|---|
| 771 | { return !static_cast<bool>(__f); } | 
|---|
| 772 |  | 
|---|
| 773 | /** | 
|---|
| 774 | *  @brief Compares a polymorphic function object wrapper against 0 | 
|---|
| 775 | *  (the NULL pointer). | 
|---|
| 776 | *  @returns @c false if the wrapper has no target, @c true otherwise | 
|---|
| 777 | * | 
|---|
| 778 | *  This function will not throw an %exception. | 
|---|
| 779 | */ | 
|---|
| 780 | template<typename _Res, typename... _Args> | 
|---|
| 781 | inline bool | 
|---|
| 782 | operator!=(const function<_Res(_Args...)>& __f, nullptr_t) noexcept | 
|---|
| 783 | { return static_cast<bool>(__f); } | 
|---|
| 784 |  | 
|---|
| 785 | /// @overload | 
|---|
| 786 | template<typename _Res, typename... _Args> | 
|---|
| 787 | inline bool | 
|---|
| 788 | operator!=(nullptr_t, const function<_Res(_Args...)>& __f) noexcept | 
|---|
| 789 | { return static_cast<bool>(__f); } | 
|---|
| 790 |  | 
|---|
| 791 |  | 
|---|
| 792 | // [20.7.15.2.7] specialized algorithms | 
|---|
| 793 |  | 
|---|
| 794 | /** | 
|---|
| 795 | *  @brief Swap the targets of two polymorphic function object wrappers. | 
|---|
| 796 | * | 
|---|
| 797 | *  This function will not throw an %exception. | 
|---|
| 798 | */ | 
|---|
| 799 | // _GLIBCXX_RESOLVE_LIB_DEFECTS | 
|---|
| 800 | // 2062. Effect contradictions w/o no-throw guarantee of std::function swaps | 
|---|
| 801 | template<typename _Res, typename... _Args> | 
|---|
| 802 | inline void | 
|---|
| 803 | swap(function<_Res(_Args...)>& __x, function<_Res(_Args...)>& __y) noexcept | 
|---|
| 804 | { __x.swap(__y); } | 
|---|
| 805 |  | 
|---|
| 806 | _GLIBCXX_END_NAMESPACE_VERSION | 
|---|
| 807 | } // namespace std | 
|---|
| 808 |  | 
|---|
| 809 | #endif // C++11 | 
|---|
| 810 |  | 
|---|
| 811 | #endif // _GLIBCXX_STD_FUNCTION_H | 
|---|
| 812 |  | 
|---|