2 //===--------------------------- mutex ------------------------------------===//
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 //===----------------------------------------------------------------------===//
23 constexpr mutex() noexcept;
26 mutex(const mutex&) = delete;
27 mutex& operator=(const mutex&) = delete;
33 typedef pthread_mutex_t* native_handle_type;
34 native_handle_type native_handle();
43 recursive_mutex(const recursive_mutex&) = delete;
44 recursive_mutex& operator=(const recursive_mutex&) = delete;
47 bool try_lock() noexcept;
50 typedef pthread_mutex_t* native_handle_type;
51 native_handle_type native_handle();
60 timed_mutex(const timed_mutex&) = delete;
61 timed_mutex& operator=(const timed_mutex&) = delete;
65 template <class Rep, class Period>
66 bool try_lock_for(const chrono::duration<Rep, Period>& rel_time);
67 template <class Clock, class Duration>
68 bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);
72 class recursive_timed_mutex
75 recursive_timed_mutex();
76 ~recursive_timed_mutex();
78 recursive_timed_mutex(const recursive_timed_mutex&) = delete;
79 recursive_timed_mutex& operator=(const recursive_timed_mutex&) = delete;
82 bool try_lock() noexcept;
83 template <class Rep, class Period>
84 bool try_lock_for(const chrono::duration<Rep, Period>& rel_time);
85 template <class Clock, class Duration>
86 bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);
90 struct defer_lock_t {};
91 struct try_to_lock_t {};
92 struct adopt_lock_t {};
94 inline constexpr defer_lock_t defer_lock{};
95 inline constexpr try_to_lock_t try_to_lock{};
96 inline constexpr adopt_lock_t adopt_lock{};
98 template <class Mutex>
102 typedef Mutex mutex_type;
104 explicit lock_guard(mutex_type& m);
105 lock_guard(mutex_type& m, adopt_lock_t);
108 lock_guard(lock_guard const&) = delete;
109 lock_guard& operator=(lock_guard const&) = delete;
112 template <class... MutexTypes>
113 class scoped_lock // C++17
116 using mutex_type = Mutex; // If MutexTypes... consists of the single type Mutex
118 explicit scoped_lock(MutexTypes&... m);
119 scoped_lock(adopt_lock_t, MutexTypes&... m);
121 scoped_lock(scoped_lock const&) = delete;
122 scoped_lock& operator=(scoped_lock const&) = delete;
124 tuple<MutexTypes&...> pm; // exposition only
127 template <class Mutex>
131 typedef Mutex mutex_type;
132 unique_lock() noexcept;
133 explicit unique_lock(mutex_type& m);
134 unique_lock(mutex_type& m, defer_lock_t) noexcept;
135 unique_lock(mutex_type& m, try_to_lock_t);
136 unique_lock(mutex_type& m, adopt_lock_t);
137 template <class Clock, class Duration>
138 unique_lock(mutex_type& m, const chrono::time_point<Clock, Duration>& abs_time);
139 template <class Rep, class Period>
140 unique_lock(mutex_type& m, const chrono::duration<Rep, Period>& rel_time);
143 unique_lock(unique_lock const&) = delete;
144 unique_lock& operator=(unique_lock const&) = delete;
146 unique_lock(unique_lock&& u) noexcept;
147 unique_lock& operator=(unique_lock&& u) noexcept;
152 template <class Rep, class Period>
153 bool try_lock_for(const chrono::duration<Rep, Period>& rel_time);
154 template <class Clock, class Duration>
155 bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);
159 void swap(unique_lock& u) noexcept;
160 mutex_type* release() noexcept;
162 bool owns_lock() const noexcept;
163 explicit operator bool () const noexcept;
164 mutex_type* mutex() const noexcept;
167 template <class Mutex>
168 void swap(unique_lock<Mutex>& x, unique_lock<Mutex>& y) noexcept;
170 template <class L1, class L2, class... L3>
171 int try_lock(L1&, L2&, L3&...);
172 template <class L1, class L2, class... L3>
173 void lock(L1&, L2&, L3&...);
177 constexpr once_flag() noexcept;
179 once_flag(const once_flag&) = delete;
180 once_flag& operator=(const once_flag&) = delete;
183 template<class Callable, class ...Args>
184 void call_once(once_flag& flag, Callable&& func, Args&&... args);
191 #include <__mutex_base>
192 #include <functional>
194 #ifndef _LIBCPP_CXX03_LANG
197 #include <__threading_support>
199 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
200 #pragma GCC system_header
204 #include <__undef_macros>
207 _LIBCPP_BEGIN_NAMESPACE_STD
209 #ifndef _LIBCPP_HAS_NO_THREADS
211 class _LIBCPP_TYPE_VIS recursive_mutex
213 __libcpp_recursive_mutex_t __m_;
220 recursive_mutex(const recursive_mutex&); // = delete;
221 recursive_mutex& operator=(const recursive_mutex&); // = delete;
225 bool try_lock() _NOEXCEPT;
226 void unlock() _NOEXCEPT;
228 typedef __libcpp_recursive_mutex_t* native_handle_type;
230 _LIBCPP_INLINE_VISIBILITY
231 native_handle_type native_handle() {return &__m_;}
234 class _LIBCPP_TYPE_VIS timed_mutex
237 condition_variable __cv_;
244 timed_mutex(const timed_mutex&); // = delete;
245 timed_mutex& operator=(const timed_mutex&); // = delete;
249 bool try_lock() _NOEXCEPT;
250 template <class _Rep, class _Period>
251 _LIBCPP_INLINE_VISIBILITY
252 bool try_lock_for(const chrono::duration<_Rep, _Period>& __d)
253 {return try_lock_until(chrono::steady_clock::now() + __d);}
254 template <class _Clock, class _Duration>
255 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
256 bool try_lock_until(const chrono::time_point<_Clock, _Duration>& __t);
257 void unlock() _NOEXCEPT;
260 template <class _Clock, class _Duration>
262 timed_mutex::try_lock_until(const chrono::time_point<_Clock, _Duration>& __t)
264 using namespace chrono;
265 unique_lock<mutex> __lk(__m_);
266 bool no_timeout = _Clock::now() < __t;
267 while (no_timeout && __locked_)
268 no_timeout = __cv_.wait_until(__lk, __t) == cv_status::no_timeout;
277 class _LIBCPP_TYPE_VIS recursive_timed_mutex
280 condition_variable __cv_;
282 __libcpp_thread_id __id_;
284 recursive_timed_mutex();
285 ~recursive_timed_mutex();
288 recursive_timed_mutex(const recursive_timed_mutex&); // = delete;
289 recursive_timed_mutex& operator=(const recursive_timed_mutex&); // = delete;
293 bool try_lock() _NOEXCEPT;
294 template <class _Rep, class _Period>
295 _LIBCPP_INLINE_VISIBILITY
296 bool try_lock_for(const chrono::duration<_Rep, _Period>& __d)
297 {return try_lock_until(chrono::steady_clock::now() + __d);}
298 template <class _Clock, class _Duration>
299 _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
300 bool try_lock_until(const chrono::time_point<_Clock, _Duration>& __t);
301 void unlock() _NOEXCEPT;
304 template <class _Clock, class _Duration>
306 recursive_timed_mutex::try_lock_until(const chrono::time_point<_Clock, _Duration>& __t)
308 using namespace chrono;
309 __libcpp_thread_id __id = __libcpp_thread_get_current_id();
310 unique_lock<mutex> lk(__m_);
311 if (__libcpp_thread_id_equal(__id, __id_))
313 if (__count_ == numeric_limits<size_t>::max())
318 bool no_timeout = _Clock::now() < __t;
319 while (no_timeout && __count_ != 0)
320 no_timeout = __cv_.wait_until(lk, __t) == cv_status::no_timeout;
330 template <class _L0, class _L1>
332 try_lock(_L0& __l0, _L1& __l1)
334 unique_lock<_L0> __u0(__l0, try_to_lock);
335 if (__u0.owns_lock())
348 #ifndef _LIBCPP_CXX03_LANG
350 template <class _L0, class _L1, class _L2, class... _L3>
352 try_lock(_L0& __l0, _L1& __l1, _L2& __l2, _L3&... __l3)
355 unique_lock<_L0> __u0(__l0, try_to_lock);
356 if (__u0.owns_lock())
358 __r = try_lock(__l1, __l2, __l3...);
367 #endif // _LIBCPP_CXX03_LANG
369 template <class _L0, class _L1>
371 lock(_L0& __l0, _L1& __l1)
376 unique_lock<_L0> __u0(__l0);
383 __libcpp_thread_yield();
385 unique_lock<_L1> __u1(__l1);
392 __libcpp_thread_yield();
396 #ifndef _LIBCPP_CXX03_LANG
398 template <class _L0, class _L1, class _L2, class ..._L3>
400 __lock_first(int __i, _L0& __l0, _L1& __l1, _L2& __l2, _L3& ...__l3)
408 unique_lock<_L0> __u0(__l0);
409 __i = try_lock(__l1, __l2, __l3...);
417 __libcpp_thread_yield();
421 unique_lock<_L1> __u1(__l1);
422 __i = try_lock(__l2, __l3..., __l0);
429 if (__i == sizeof...(_L3) + 1)
433 __libcpp_thread_yield();
436 __lock_first(__i - 2, __l2, __l3..., __l0, __l1);
442 template <class _L0, class _L1, class _L2, class ..._L3>
443 inline _LIBCPP_INLINE_VISIBILITY
445 lock(_L0& __l0, _L1& __l1, _L2& __l2, _L3& ...__l3)
447 __lock_first(0, __l0, __l1, __l2, __l3...);
451 inline _LIBCPP_INLINE_VISIBILITY
452 void __unlock(_L0& __l0) {
456 template <class _L0, class _L1>
457 inline _LIBCPP_INLINE_VISIBILITY
458 void __unlock(_L0& __l0, _L1& __l1) {
463 template <class _L0, class _L1, class _L2, class ..._L3>
464 inline _LIBCPP_INLINE_VISIBILITY
465 void __unlock(_L0& __l0, _L1& __l1, _L2& __l2, _L3&... __l3) {
468 _VSTD::__unlock(__l2, __l3...);
471 #endif // _LIBCPP_CXX03_LANG
473 #if _LIBCPP_STD_VER > 14
474 template <class ..._Mutexes>
475 class _LIBCPP_TEMPLATE_VIS scoped_lock;
478 class _LIBCPP_TEMPLATE_VIS scoped_lock<> {
480 explicit scoped_lock() {}
481 ~scoped_lock() = default;
483 _LIBCPP_INLINE_VISIBILITY
484 explicit scoped_lock(adopt_lock_t) {}
486 scoped_lock(scoped_lock const&) = delete;
487 scoped_lock& operator=(scoped_lock const&) = delete;
490 template <class _Mutex>
491 class _LIBCPP_TEMPLATE_VIS scoped_lock<_Mutex> {
493 typedef _Mutex mutex_type;
497 explicit scoped_lock(mutex_type & __m) _LIBCPP_THREAD_SAFETY_ANNOTATION(acquire_capability(__m))
498 : __m_(__m) {__m_.lock();}
500 ~scoped_lock() _LIBCPP_THREAD_SAFETY_ANNOTATION(release_capability()) {__m_.unlock();}
502 _LIBCPP_INLINE_VISIBILITY
503 explicit scoped_lock(adopt_lock_t, mutex_type& __m) _LIBCPP_THREAD_SAFETY_ANNOTATION(requires_capability(__m))
506 scoped_lock(scoped_lock const&) = delete;
507 scoped_lock& operator=(scoped_lock const&) = delete;
510 template <class ..._MArgs>
511 class _LIBCPP_TEMPLATE_VIS scoped_lock
513 static_assert(sizeof...(_MArgs) > 1, "At least 2 lock types required");
514 typedef tuple<_MArgs&...> _MutexTuple;
517 _LIBCPP_INLINE_VISIBILITY
518 explicit scoped_lock(_MArgs&... __margs)
521 _VSTD::lock(__margs...);
524 _LIBCPP_INLINE_VISIBILITY
525 scoped_lock(adopt_lock_t, _MArgs&... __margs)
530 _LIBCPP_INLINE_VISIBILITY
532 typedef typename __make_tuple_indices<sizeof...(_MArgs)>::type _Indices;
533 __unlock_unpack(_Indices{}, __t_);
536 scoped_lock(scoped_lock const&) = delete;
537 scoped_lock& operator=(scoped_lock const&) = delete;
540 template <size_t ..._Indx>
541 _LIBCPP_INLINE_VISIBILITY
542 static void __unlock_unpack(__tuple_indices<_Indx...>, _MutexTuple& __mt) {
543 _VSTD::__unlock(_VSTD::get<_Indx>(__mt)...);
549 #endif // _LIBCPP_STD_VER > 14
550 #endif // !_LIBCPP_HAS_NO_THREADS
552 struct _LIBCPP_TEMPLATE_VIS once_flag;
554 #ifndef _LIBCPP_CXX03_LANG
556 template<class _Callable, class... _Args>
557 _LIBCPP_INLINE_VISIBILITY
558 void call_once(once_flag&, _Callable&&, _Args&&...);
560 #else // _LIBCPP_CXX03_LANG
562 template<class _Callable>
563 _LIBCPP_INLINE_VISIBILITY
564 void call_once(once_flag&, _Callable&);
566 template<class _Callable>
567 _LIBCPP_INLINE_VISIBILITY
568 void call_once(once_flag&, const _Callable&);
570 #endif // _LIBCPP_CXX03_LANG
572 struct _LIBCPP_TEMPLATE_VIS once_flag
574 _LIBCPP_INLINE_VISIBILITY
576 once_flag() _NOEXCEPT : __state_(0) {}
579 once_flag(const once_flag&); // = delete;
580 once_flag& operator=(const once_flag&); // = delete;
582 unsigned long __state_;
584 #ifndef _LIBCPP_CXX03_LANG
585 template<class _Callable, class... _Args>
587 void call_once(once_flag&, _Callable&&, _Args&&...);
588 #else // _LIBCPP_CXX03_LANG
589 template<class _Callable>
591 void call_once(once_flag&, _Callable&);
593 template<class _Callable>
595 void call_once(once_flag&, const _Callable&);
596 #endif // _LIBCPP_CXX03_LANG
599 #ifndef _LIBCPP_CXX03_LANG
602 class __call_once_param
606 _LIBCPP_INLINE_VISIBILITY
607 explicit __call_once_param(_Fp& __f) : __f_(__f) {}
609 _LIBCPP_INLINE_VISIBILITY
612 typedef typename __make_tuple_indices<tuple_size<_Fp>::value, 1>::type _Index;
617 template <size_t ..._Indices>
618 _LIBCPP_INLINE_VISIBILITY
619 void __execute(__tuple_indices<_Indices...>)
621 __invoke(_VSTD::get<0>(_VSTD::move(__f_)), _VSTD::get<_Indices>(_VSTD::move(__f_))...);
628 class __call_once_param
632 _LIBCPP_INLINE_VISIBILITY
633 explicit __call_once_param(_Fp& __f) : __f_(__f) {}
635 _LIBCPP_INLINE_VISIBILITY
646 __call_once_proxy(void* __vp)
648 __call_once_param<_Fp>* __p = static_cast<__call_once_param<_Fp>*>(__vp);
652 _LIBCPP_FUNC_VIS void __call_once(volatile unsigned long&, void*, void(*)(void*));
654 #ifndef _LIBCPP_CXX03_LANG
656 template<class _Callable, class... _Args>
657 inline _LIBCPP_INLINE_VISIBILITY
659 call_once(once_flag& __flag, _Callable&& __func, _Args&&... __args)
661 if (__libcpp_acquire_load(&__flag.__state_) != ~0ul)
663 typedef tuple<_Callable&&, _Args&&...> _Gp;
664 _Gp __f(_VSTD::forward<_Callable>(__func), _VSTD::forward<_Args>(__args)...);
665 __call_once_param<_Gp> __p(__f);
666 __call_once(__flag.__state_, &__p, &__call_once_proxy<_Gp>);
670 #else // _LIBCPP_CXX03_LANG
672 template<class _Callable>
673 inline _LIBCPP_INLINE_VISIBILITY
675 call_once(once_flag& __flag, _Callable& __func)
677 if (__libcpp_acquire_load(&__flag.__state_) != ~0ul)
679 __call_once_param<_Callable> __p(__func);
680 __call_once(__flag.__state_, &__p, &__call_once_proxy<_Callable>);
684 template<class _Callable>
685 inline _LIBCPP_INLINE_VISIBILITY
687 call_once(once_flag& __flag, const _Callable& __func)
689 if (__libcpp_acquire_load(&__flag.__state_) != ~0ul)
691 __call_once_param<const _Callable> __p(__func);
692 __call_once(__flag.__state_, &__p, &__call_once_proxy<const _Callable>);
696 #endif // _LIBCPP_CXX03_LANG
698 _LIBCPP_END_NAMESPACE_STD
702 #endif // _LIBCPP_MUTEX