CKTIS / C
mtx_unlock — odomknutie mutexu
Funkcia mtx_unlock z <threads.h> odomkne mutex vlastnený volajúcim vláknom a vráti kód úspechu alebo chyby.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int mtx_unlock(mtx_t *mtx);mtx_unlock(mtx) odomkne mutex, na ktorý ukazuje mtx. Argument musí ukazovať na inicializovaný, stále existujúci mutex zamknutý volajúcim vláknom. Odomknutie nezamknutého mutexu alebo mutexu vlastneného iným vláknom spôsobuje nedefinované správanie.
Pri úspechu vracia thrd_success; ak požiadavku nemožno splniť, vracia thrd_error. Chybový kód nenahrádza dodržanie podmienok volania. Odomknutie sa synchronizuje s neskorším získaním toho istého mutexu, čím zabezpečuje viditeľnosť chránených zápisov.
Príklad používa jedno vlákno: inicializuje mutex, zamkne ho, nastaví value, odomkne ho a zničí. Ukazuje životný cyklus, nie súperenie medzi vláknami. Samotná voľba režimu C23 nezaručuje dostupnosť knižnice vlákien za behu.
Príklady
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>
int main(void)
{
mtx_t mutex;
int value = 0;
if (mtx_init(&mutex, mtx_plain) != thrd_success)
return EXIT_FAILURE;
if (mtx_lock(&mutex) != thrd_success) {
mtx_destroy(&mutex);
return EXIT_FAILURE;
}
value = 42;
if (mtx_unlock(&mutex) != thrd_success)
abort();
mtx_destroy(&mutex);
printf("%d\n", value);
return EXIT_SUCCESS;
}Výsledok
42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.