Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

mtx_unlock — sbloccare un mutex

mtx_unlock di <threads.h> sblocca un mutex appartenente al thread chiamante e restituisce un codice di successo o di errore.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <threads.h>
int mtx_unlock(mtx_t *mtx);

mtx_unlock(mtx) sblocca il mutex puntato da mtx. L’argomento deve puntare a un mutex inizializzato, ancora esistente e bloccato dal thread chiamante. Sbloccare un mutex non bloccato o appartenente a un altro thread causa un comportamento indefinito.

In caso di successo restituisce thrd_success; se la richiesta non può essere soddisfatta, restituisce thrd_error. Un codice di errore non sostituisce il rispetto dei requisiti della chiamata. Lo sblocco si sincronizza con una successiva acquisizione dello stesso mutex, rendendo visibili le scritture protette.

L’esempio usa un solo thread: inizializza il mutex, lo blocca, assegna un valore a value, lo sblocca e lo distrugge. Mostra il ciclo di vita, non la contesa tra thread. La sola selezione della modalità C23 non garantisce la disponibilità della libreria dei thread durante l’esecuzione.

Esempi

#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;
}

Risultato

42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti