Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

mtx_unlock — odemknutí mutexu

Funkce mtx_unlock z <threads.h> odemkne mutex vlastněný volajícím vláknem a vrátí kód úspěchu nebo chyby.

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

Syntaxe

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

mtx_unlock(mtx) odemkne mutex, na který ukazuje mtx. Argument musí ukazovat na inicializovaný, stále existující mutex zamknutý volajícím vláknem. Odemknutí nezamknutého mutexu nebo mutexu vlastněného jiným vláknem způsobuje nedefinované chování.

Při úspěchu vrací thrd_success; pokud požadavek nelze splnit, vrací thrd_error. Chybový kód nenahrazuje dodržení podmínek volání. Odemknutí se synchronizuje s pozdějším získáním téhož mutexu, a zajišťuje tak viditelnost chráněných zápisů.

Příklad používá jedno vlákno: inicializuje mutex, zamkne jej, nastaví value, odemkne jej a zničí. Ukazuje životní cyklus, nikoli soupeření mezi vlákny. Samotná volba režimu C23 nezaručuje dostupnost knihovny vláken za běhu.

Pří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ýsledek

42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje