mtx_timedlock

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für nebenläufige Programmierung

Threads thrd_create thrd_equal thrd_current    thrd_sleep thrd_yield thrd_exit thrd_detach thrd_join thrd_successthrd_timedoutthrd_busythrd_nomemthrd_error    Atomare Operationen atomic_init ATOMIC_VAR_INIT (bis C23) ATOMIC_***_LOCK_FREE atomic_is_lock_free atomic_store atomic_load atomic_exchange atomic_compare_exchange atomic_fetch_add atomic_fetch_sub atomic_fetch_or atomic_fetch_xor atomic_fetch_and

Atomare Flags atomic_flag ATOMIC_FLAG_INIT atomic_flag_test_and_set atomic_flag_clear Speicherordnung memory_order kill_dependency atomic_thread_fence atomic_signal_fence Gegenseitiger Ausschluss mtx_init mtx_lock mtx_timedlock mtx_trylock call_once mtx_unlock mtx_destroy mtx_plainmtx_recursivemtx_timed Bedingungsvariablen cnd_init cnd_signal cnd_broadcast cnd_wait cnd_timedwait cnd_destroy Thread-lokaler Speicher thread_local TSS_DTOR_ITERATIONS    tss_create tss_get tss_set tss_delete

 

Definiert im Header <threads.h>
int mtx_timedlock( mtx_t *restrict mutex,                    const struct timespec *restrict time_point );		(seit C11)

Blockiert den aktuellen Thread, bis der durch mutex zeigende Mutex gesperrt ist oder bis der absolute Kalenderzeitpunkt basierend auf TIME_UTC, auf den time_point zeigt, erreicht wurde.

Da diese Funktion eine absolute Zeit verwendet, muss der Kalenderzeitpunkt manuell berechnet werden, falls eine Dauer benötigt wird.

Das Verhalten ist undefiniert, wenn der aktuelle Thread den Mutex bereits gesperrt hat und der Mutex nicht rekursiv ist.

Das Verhalten ist undefiniert, wenn der Mutex kein Timeout unterstützt.

Vorherige Aufrufe von mtx_unlock für denselben Mutex *synchronisieren mit* dieser Operation (wenn diese Operation erfolgreich ist), und alle Sperr-/Entsperroperationen für einen gegebenen Mutex bilden eine einzige totale Reihenfolge (ähnlich der Modifikationsreihenfolge eines Atoms).

Parameter

mutex	-	Zeiger auf die zu sperrende Mutex
time_point	-	Zeiger auf die absolute Kalenderzeit, bis zu der auf das Timeout gewartet werden soll

Rückgabewert

thrd_success bei Erfolg, thrd_timedout, wenn die Timeout-Zeit erreicht wurde, bevor der Mutex gesperrt werden konnte, thrd_error bei einem Fehler.

Referenzen

• C17-Standard (ISO/IEC 9899:2018)

• 7.26.4.4 Die Funktion mtx_timedlock (S. 278)

• C11-Standard (ISO/IEC 9899:2011)

• 7.26.4.4 Die Funktion mtx_timedlock (S. 381-382)

Siehe auch

timespec (C11)	Zeit in Sekunden und Nanosekunden (Struktur)
mtx_lock (C11)	blockiert, bis ein Mutex gesperrt ist (Funktion)
mtx_trylock (C11)	sperrt einen Mutex oder kehrt zurück, ohne zu blockieren, wenn er bereits gesperrt ist (Funktion)
mtx_unlock (C11)	entsperrt einen Mutex (Funktion)
C++ Dokumentation für timed_mutex::try_lock_until
C++ Dokumentation für recursive_timed_mutex::try_lock_until

Externe Links

GNU GCC Libc Manual: ISO-C-Mutexes