mtx_timedlock

 

C

Language

Standard Library

Type support

Dynamic memory management

Error handling

Program utilities

Date and time utilities

Strings library

Algorithms

Numerics

Input/output support

Localization support

Thread support (C11)

Atomic operations (C11)

 

Thread support library

Threads
thrd_create thrd_equal thrd_current thrd_sleep thrd_yield thrd_exit	thrd_detach thrd_join thrd_success thrd_timedout thrd_busy thrd_nomem thrd_error
Mutual exclusion
mtx_init mtx_lock mtx_timedlock mtx_trylock	mtx_unlock mtx_destroy mtx_types
Call once
ONCE_FLAG_INIT	call_once
Condition variables
cnd_init cnd_signal cnd_broadcast	cnd_wait cnd_timedwait cnd_destroy
Thread-local storage
thread_local TSS_DTOR_ITERATIONS tss_create	tss_get tss_set tss_delete

 

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 time point pointed to by time_point has been reached.

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.

Parameters

mutex	-	pointer to the mutex to lock
time_point	-	pointer to the timeout time to wait until

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 occurrs.

See also

mtx_lock (C11)	blocks until locks a mutex (function)
mtx_trylock (C11)	locks a mutex or returns without blocking if already locked (function)
mtx_unlock (C11)	unlocks a mutex (function)