xref: /netbsd-src/external/gpl3/gcc.old/dist/libstdc++-v3/include/bits/std_function.h (revision 3ad841b2f6c3e57f95d0e6cec2feda2e43f1ebd0)
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