2 //===-------------------------- utility -----------------------------------===//
4 // The LLVM Compiler Infrastructure
6 // This file is dual licensed under the MIT and the University of Illinois Open
7 // Source Licenses. See LICENSE.TXT for details.
9 //===----------------------------------------------------------------------===//
11 #ifndef _LIBCPP_UTILITY
12 #define _LIBCPP_UTILITY
26 template<class T> bool operator!=(const T&, const T&);
27 template<class T> bool operator> (const T&, const T&);
28 template<class T> bool operator<=(const T&, const T&);
29 template<class T> bool operator>=(const T&, const T&);
34 swap(T& a, T& b) noexcept(is_nothrow_move_constructible<T>::value &&
35 is_nothrow_move_assignable<T>::value);
37 template <class T, size_t N>
39 swap(T (&a)[N], T (&b)[N]) noexcept(noexcept(swap(*a, *b)));
41 template <class T> T&& forward(typename remove_reference<T>::type& t) noexcept;
42 template <class T> T&& forward(typename remove_reference<T>::type&& t) noexcept;
44 template <class T> typename remove_reference<T>::type&& move(T&&) noexcept;
49 !is_nothrow_move_constructible<T>::value && is_copy_constructible<T>::value,
53 move_if_noexcept(T& x) noexcept;
55 template <class T> typename add_rvalue_reference<T>::type declval() noexcept;
57 template <class T1, class T2>
60 typedef T1 first_type;
61 typedef T2 second_type;
66 pair(const pair&) = default;
67 pair(pair&&) = default;
69 pair(const T1& x, const T2& y);
70 template <class U, class V> pair(U&& x, V&& y);
71 template <class U, class V> pair(const pair<U, V>& p);
72 template <class U, class V> pair(pair<U, V>&& p);
73 template <class... Args1, class... Args2>
74 pair(piecewise_construct_t, tuple<Args1...> first_args,
75 tuple<Args2...> second_args);
77 template <class U, class V> pair& operator=(const pair<U, V>& p);
78 pair& operator=(pair&& p) noexcept(is_nothrow_move_assignable<T1>::value &&
79 is_nothrow_move_assignable<T2>::value);
80 template <class U, class V> pair& operator=(pair<U, V>&& p);
82 void swap(pair& p) noexcept(noexcept(swap(first, p.first)) &&
83 noexcept(swap(second, p.second)));
86 template <class T1, class T2> bool operator==(const pair<T1,T2>&, const pair<T1,T2>&);
87 template <class T1, class T2> bool operator!=(const pair<T1,T2>&, const pair<T1,T2>&);
88 template <class T1, class T2> bool operator< (const pair<T1,T2>&, const pair<T1,T2>&);
89 template <class T1, class T2> bool operator> (const pair<T1,T2>&, const pair<T1,T2>&);
90 template <class T1, class T2> bool operator>=(const pair<T1,T2>&, const pair<T1,T2>&);
91 template <class T1, class T2> bool operator<=(const pair<T1,T2>&, const pair<T1,T2>&);
93 template <class T1, class T2> pair<V1, V2> make_pair(T1&&, T2&&);
94 template <class T1, class T2>
96 swap(pair<T1, T2>& x, pair<T1, T2>& y) noexcept(noexcept(x.swap(y)));
98 struct piecewise_construct_t { };
99 constexpr piecewise_construct_t piecewise_construct = piecewise_construct_t();
101 template <class T> class tuple_size;
102 template <size_t I, class T> class tuple_element;
104 template <class T1, class T2> struct tuple_size<std::pair<T1, T2> >;
105 template <class T1, class T2> struct tuple_element<0, std::pair<T1, T2> >;
106 template <class T1, class T2> struct tuple_element<1, std::pair<T1, T2> >;
108 template<size_t I, class T1, class T2>
109 typename tuple_element<I, std::pair<T1, T2> >::type&
110 get(std::pair<T1, T2>&) noexcept;
112 template<size_t I, class T1, class T2>
113 const typename const tuple_element<I, std::pair<T1, T2> >::type&
114 get(const std::pair<T1, T2>&) noexcept;
116 template<size_t I, class T1, class T2>
117 typename tuple_element<I, std::pair<T1, T2> >::type&&
118 get(std::pair<T1, T2>&&) noexcept;
126 #include <type_traits>
128 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
129 #pragma GCC system_header
132 _LIBCPP_BEGIN_NAMESPACE_STD
138 inline _LIBCPP_INLINE_VISIBILITY
140 operator!=(const _Tp& __x, const _Tp& __y)
142 return !(__x == __y);
146 inline _LIBCPP_INLINE_VISIBILITY
148 operator> (const _Tp& __x, const _Tp& __y)
154 inline _LIBCPP_INLINE_VISIBILITY
156 operator<=(const _Tp& __x, const _Tp& __y)
162 inline _LIBCPP_INLINE_VISIBILITY
164 operator>=(const _Tp& __x, const _Tp& __y)
173 template <class _ForwardIterator1, class _ForwardIterator2>
174 inline _LIBCPP_INLINE_VISIBILITY
176 swap_ranges(_ForwardIterator1 __first1, _ForwardIterator1 __last1, _ForwardIterator2 __first2)
178 for(; __first1 != __last1; ++__first1, ++__first2)
179 swap(*__first1, *__first2);
183 template<class _Tp, size_t _Np>
184 inline _LIBCPP_INLINE_VISIBILITY
186 swap(_Tp (&__a)[_Np], _Tp (&__b)[_Np]) _NOEXCEPT_(__is_nothrow_swappable<_Tp>::value)
188 _VSTD::swap_ranges(__a, __a + _Np, __b);
192 inline _LIBCPP_INLINE_VISIBILITY
193 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
196 !is_nothrow_move_constructible<_Tp>::value && is_copy_constructible<_Tp>::value,
200 #else // _LIBCPP_HAS_NO_RVALUE_REFERENCES
203 move_if_noexcept(_Tp& __x) _NOEXCEPT
205 return _VSTD::move(__x);
208 struct _LIBCPP_VISIBLE piecewise_construct_t { };
209 #if defined(_LIBCPP_HAS_NO_CONSTEXPR) || defined(_LIBCPP_BUILDING_UTILITY)
210 extern const piecewise_construct_t piecewise_construct;// = piecewise_construct_t();
212 constexpr piecewise_construct_t piecewise_construct = piecewise_construct_t();
215 template <class _T1, class _T2>
216 struct _LIBCPP_VISIBLE pair
218 typedef _T1 first_type;
219 typedef _T2 second_type;
224 // pair(const pair&) = default;
225 // pair(pair&&) = default;
227 _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR pair() : first(), second() {}
229 _LIBCPP_INLINE_VISIBILITY pair(const _T1& __x, const _T2& __y)
230 : first(__x), second(__y) {}
232 template<class _U1, class _U2>
233 _LIBCPP_INLINE_VISIBILITY
234 pair(const pair<_U1, _U2>& __p
235 #ifndef _LIBCPP_HAS_NO_ADVANCED_SFINAE
236 ,typename enable_if<is_convertible<const _U1&, _T1>::value &&
237 is_convertible<const _U2&, _T2>::value>::type* = 0
240 : first(__p.first), second(__p.second) {}
242 _LIBCPP_INLINE_VISIBILITY
243 pair(const pair& __p)
244 _NOEXCEPT_(is_nothrow_copy_constructible<first_type>::value &&
245 is_nothrow_copy_constructible<second_type>::value)
251 _LIBCPP_INLINE_VISIBILITY
252 pair& operator=(const pair& __p)
253 _NOEXCEPT_(is_nothrow_copy_assignable<first_type>::value &&
254 is_nothrow_copy_assignable<second_type>::value)
261 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
263 template <class _U1, class _U2,
264 class = typename enable_if<is_convertible<_U1, first_type>::value &&
265 is_convertible<_U2, second_type>::value>::type>
266 _LIBCPP_INLINE_VISIBILITY
267 pair(_U1&& __u1, _U2&& __u2)
268 : first(_VSTD::forward<_U1>(__u1)),
269 second(_VSTD::forward<_U2>(__u2))
272 template<class _U1, class _U2>
273 _LIBCPP_INLINE_VISIBILITY
274 pair(pair<_U1, _U2>&& __p,
275 typename enable_if<is_convertible<_U1, _T1>::value &&
276 is_convertible<_U2, _T2>::value>::type* = 0)
277 : first(_VSTD::forward<_U1>(__p.first)),
278 second(_VSTD::forward<_U2>(__p.second)) {}
280 _LIBCPP_INLINE_VISIBILITY
281 pair(pair&& __p) _NOEXCEPT_(is_nothrow_move_constructible<first_type>::value &&
282 is_nothrow_move_constructible<second_type>::value)
283 : first(_VSTD::forward<first_type>(__p.first)),
284 second(_VSTD::forward<second_type>(__p.second))
288 _LIBCPP_INLINE_VISIBILITY
290 operator=(pair&& __p) _NOEXCEPT_(is_nothrow_move_assignable<first_type>::value &&
291 is_nothrow_move_assignable<second_type>::value)
293 first = _VSTD::forward<first_type>(__p.first);
294 second = _VSTD::forward<second_type>(__p.second);
298 #ifndef _LIBCPP_HAS_NO_VARIADICS
300 template<class _Tuple,
301 class = typename enable_if<__tuple_convertible<_Tuple, pair>::value>::type>
302 _LIBCPP_INLINE_VISIBILITY
304 : first(_VSTD::forward<typename tuple_element<0,
305 typename __make_tuple_types<_Tuple>::type>::type>(get<0>(__p))),
306 second(_VSTD::forward<typename tuple_element<1,
307 typename __make_tuple_types<_Tuple>::type>::type>(get<1>(__p)))
312 template <class... _Args1, class... _Args2>
313 _LIBCPP_INLINE_VISIBILITY
314 pair(piecewise_construct_t __pc, tuple<_Args1...> __first_args,
315 tuple<_Args2...> __second_args)
316 : pair(__pc, __first_args, __second_args,
317 typename __make_tuple_indices<sizeof...(_Args1)>::type(),
318 typename __make_tuple_indices<sizeof...(_Args2) >::type())
321 template <class _Tuple,
322 class = typename enable_if<__tuple_assignable<_Tuple, pair>::value>::type>
323 _LIBCPP_INLINE_VISIBILITY
325 operator=(_Tuple&& __p)
327 typedef typename __make_tuple_types<_Tuple>::type _TupleRef;
328 typedef typename tuple_element<0, _TupleRef>::type _U0;
329 typedef typename tuple_element<1, _TupleRef>::type _U1;
330 first = _VSTD::forward<_U0>(_VSTD::get<0>(__p));
331 second = _VSTD::forward<_U1>(_VSTD::get<1>(__p));
335 #endif // _LIBCPP_HAS_NO_VARIADICS
337 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
338 _LIBCPP_INLINE_VISIBILITY
340 swap(pair& __p) _NOEXCEPT_(__is_nothrow_swappable<first_type>::value &&
341 __is_nothrow_swappable<second_type>::value)
343 _VSTD::iter_swap(&first, &__p.first);
344 _VSTD::iter_swap(&second, &__p.second);
348 #ifndef _LIBCPP_HAS_NO_VARIADICS
349 template <class... _Args1, class... _Args2, size_t... _I1, size_t... _I2>
350 _LIBCPP_INLINE_VISIBILITY
351 pair(piecewise_construct_t,
352 tuple<_Args1...>& __first_args, tuple<_Args2...>& __second_args,
353 __tuple_indices<_I1...>, __tuple_indices<_I2...>);
354 #endif // _LIBCPP_HAS_NO_VARIADICS
357 template <class _T1, class _T2>
358 inline _LIBCPP_INLINE_VISIBILITY
360 operator==(const pair<_T1,_T2>& __x, const pair<_T1,_T2>& __y)
362 return __x.first == __y.first && __x.second == __y.second;
365 template <class _T1, class _T2>
366 inline _LIBCPP_INLINE_VISIBILITY
368 operator!=(const pair<_T1,_T2>& __x, const pair<_T1,_T2>& __y)
370 return !(__x == __y);
373 template <class _T1, class _T2>
374 inline _LIBCPP_INLINE_VISIBILITY
376 operator< (const pair<_T1,_T2>& __x, const pair<_T1,_T2>& __y)
378 return __x.first < __y.first || (!(__y.first < __x.first) && __x.second < __y.second);
381 template <class _T1, class _T2>
382 inline _LIBCPP_INLINE_VISIBILITY
384 operator> (const pair<_T1,_T2>& __x, const pair<_T1,_T2>& __y)
389 template <class _T1, class _T2>
390 inline _LIBCPP_INLINE_VISIBILITY
392 operator>=(const pair<_T1,_T2>& __x, const pair<_T1,_T2>& __y)
397 template <class _T1, class _T2>
398 inline _LIBCPP_INLINE_VISIBILITY
400 operator<=(const pair<_T1,_T2>& __x, const pair<_T1,_T2>& __y)
405 template <class _T1, class _T2>
406 inline _LIBCPP_INLINE_VISIBILITY
409 __is_swappable<_T1>::value &&
410 __is_swappable<_T2>::value,
413 swap(pair<_T1, _T2>& __x, pair<_T1, _T2>& __y)
414 _NOEXCEPT_((__is_nothrow_swappable<_T1>::value &&
415 __is_nothrow_swappable<_T2>::value))
420 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
422 template <class _Tp> class _LIBCPP_VISIBLE reference_wrapper;
425 struct ___make_pair_return
431 struct ___make_pair_return<reference_wrapper<_Tp>>
437 struct __make_pair_return
439 typedef typename ___make_pair_return<typename decay<_Tp>::type>::type type;
442 template <class _T1, class _T2>
443 inline _LIBCPP_INLINE_VISIBILITY
444 pair<typename __make_pair_return<_T1>::type, typename __make_pair_return<_T2>::type>
445 make_pair(_T1&& __t1, _T2&& __t2)
447 return pair<typename __make_pair_return<_T1>::type, typename __make_pair_return<_T2>::type>
448 (_VSTD::forward<_T1>(__t1), _VSTD::forward<_T2>(__t2));
451 #else // _LIBCPP_HAS_NO_RVALUE_REFERENCES
453 template <class _T1, class _T2>
454 inline _LIBCPP_INLINE_VISIBILITY
456 make_pair(_T1 __x, _T2 __y)
458 return pair<_T1, _T2>(__x, __y);
461 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
463 template <class _T1, class _T2>
464 class _LIBCPP_VISIBLE tuple_size<pair<_T1, _T2> >
465 : public integral_constant<size_t, 2> {};
467 template <class _T1, class _T2>
468 class _LIBCPP_VISIBLE tuple_size<const pair<_T1, _T2> >
469 : public integral_constant<size_t, 2> {};
471 template <class _T1, class _T2>
472 class _LIBCPP_VISIBLE tuple_element<0, pair<_T1, _T2> >
478 template <class _T1, class _T2>
479 class _LIBCPP_VISIBLE tuple_element<1, pair<_T1, _T2> >
485 template <class _T1, class _T2>
486 class _LIBCPP_VISIBLE tuple_element<0, const pair<_T1, _T2> >
489 typedef const _T1 type;
492 template <class _T1, class _T2>
493 class _LIBCPP_VISIBLE tuple_element<1, const pair<_T1, _T2> >
496 typedef const _T2 type;
499 template <size_t _Ip> struct __get_pair;
504 template <class _T1, class _T2>
506 _LIBCPP_INLINE_VISIBILITY
508 get(pair<_T1, _T2>& __p) _NOEXCEPT {return __p.first;}
510 template <class _T1, class _T2>
512 _LIBCPP_INLINE_VISIBILITY
514 get(const pair<_T1, _T2>& __p) _NOEXCEPT {return __p.first;}
516 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
518 template <class _T1, class _T2>
520 _LIBCPP_INLINE_VISIBILITY
522 get(pair<_T1, _T2>&& __p) _NOEXCEPT {return _VSTD::forward<_T1>(__p.first);}
524 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
530 template <class _T1, class _T2>
532 _LIBCPP_INLINE_VISIBILITY
534 get(pair<_T1, _T2>& __p) _NOEXCEPT {return __p.second;}
536 template <class _T1, class _T2>
538 _LIBCPP_INLINE_VISIBILITY
540 get(const pair<_T1, _T2>& __p) _NOEXCEPT {return __p.second;}
542 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
544 template <class _T1, class _T2>
546 _LIBCPP_INLINE_VISIBILITY
548 get(pair<_T1, _T2>&& __p) _NOEXCEPT {return _VSTD::forward<_T2>(__p.second);}
550 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
553 template <size_t _Ip, class _T1, class _T2>
554 _LIBCPP_INLINE_VISIBILITY inline
555 typename tuple_element<_Ip, pair<_T1, _T2> >::type&
556 get(pair<_T1, _T2>& __p) _NOEXCEPT
558 return __get_pair<_Ip>::get(__p);
561 template <size_t _Ip, class _T1, class _T2>
562 _LIBCPP_INLINE_VISIBILITY inline
563 const typename tuple_element<_Ip, pair<_T1, _T2> >::type&
564 get(const pair<_T1, _T2>& __p) _NOEXCEPT
566 return __get_pair<_Ip>::get(__p);
569 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
571 template <size_t _Ip, class _T1, class _T2>
572 _LIBCPP_INLINE_VISIBILITY inline
573 typename tuple_element<_Ip, pair<_T1, _T2> >::type&&
574 get(pair<_T1, _T2>&& __p) _NOEXCEPT
576 return __get_pair<_Ip>::get(_VSTD::move(__p));
579 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
581 _LIBCPP_END_NAMESPACE_STD
583 #endif // _LIBCPP_UTILITY