From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/thread%2Fmtx_timedlock.html | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 devdocs/c/thread%2Fmtx_timedlock.html (limited to 'devdocs/c/thread%2Fmtx_timedlock.html') diff --git a/devdocs/c/thread%2Fmtx_timedlock.html b/devdocs/c/thread%2Fmtx_timedlock.html new file mode 100644 index 00000000..706bf816 --- /dev/null +++ b/devdocs/c/thread%2Fmtx_timedlock.html @@ -0,0 +1,35 @@ +

mtx_timedlock

Defined in header <threads.h> 
int mtx_timedlock( mtx_t *restrict mutex,
+                   const struct timespec *restrict time_point );
+		 (since C11)

Blocks the current thread until the mutex pointed to by mutex is locked or until the TIME_UTC based absolute calendar time point pointed to by time_point has been reached.

+

Since this function takes an absolute time, if a duration is required, the calendar time point must be calculated manually.

+

The behavior is undefined if the current thread has already locked the mutex and the mutex is not recursive.

+

The behavior is undefined if the mutex does not support timeout.

+

Prior calls to mtx_unlock on the same mutex synchronize-with this operation (if this operation succeeds), and all lock/unlock operations on any given mutex form a single total order (similar to the modification order of an atomic)

+

Parameters

+ + +
mutex - pointer to the mutex to lock
time_point - pointer to the absolute calendar time until which to wait for the timeout

Return value

thrd_success if successful, thrd_timedout if the timeout time has been reached before the mutex is locked, thrd_error if an error occurs.

+

References

See also

+ + + + + +
+
(C11)
 time in seconds and nanoseconds
(struct)
+
(C11)
 blocks until locks a mutex
(function)
+
(C11)
 locks a mutex or returns without blocking if already locked
(function)
+
(C11)
 unlocks a mutex
(function)
C++ documentation for timed_mutex::try_lock_until
C++ documentation for recursive_timed_mutex::try_lock_until
+ +
+GNU GCC Libc Manual: ISO-C-Mutexes
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/thread/mtx_timedlock +

+
-- cgit v1.2.3