mtx_trylock

 

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_trylock( mtx_t *mutex );		(seit C11)

Versucht, die durch mutex dargestellte Mutex-Sperre ohne Blockieren zu erhalten. Wird sofort zurückgegeben, wenn die Mutex-Sperre bereits gesetzt ist.

Frühere Aufrufe von mtx_unlock für denselben Mutex *synchronisieren* mit dieser Operation (falls diese Operation erfolgreich ist), und alle Sperr-/Entsperroperationen auf einem gegebenen Mutex bilden eine einzige totale Ordnung (ähnlich der Modifikationsreihenfolge eines Atomwerts).

Parameter

mutex

-

Zeiger auf die zu sperrende Mutex

Rückgabewert

thrd_success bei Erfolg, thrd_busy, wenn die Mutex-Sperre bereits gesetzt ist oder aufgrund eines fehlerhaften Erwerbs einer verfügbaren Mutex-Sperre, thrd_error, wenn ein Fehler auftritt.

Fehlerberichte

Die folgenden verhaltensändernden Defect Reports wurden rückwirkend auf zuvor veröffentlichte C-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
DR 470	C11	mtx_trylock durfte nicht fehlerhaft fehlschlagen	erlaubt

Referenzen

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

• 7.26.4.5 Die Funktion mtx_trylock (S. 278-279)

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

• 7.26.4.5 Die Funktion mtx_trylock (S. 382)

Siehe auch

mtx_lock (C11)	blockiert, bis ein Mutex gesperrt ist (Funktion)
mtx_timedlock (C11)	blockiert, bis ein Mutex gesperrt ist, oder läuft ab (Funktion)
mtx_unlock (C11)	entsperrt einen Mutex (Funktion)
C++ Dokumentation für mutex::try_lock
C++ Dokumentation für timed_mutex::try_lock
C++ Dokumentation für recursive_mutex::try_lock
C++ Dokumentation für recursive_timed_mutex::try_lock