CKTIS / C
mtx_init — een mutex initialiseren
mtx_init uit <threads.h> initialiseert een mutex met geselecteerde eigenschappen. Controleer het resultaat voordat je het object gebruikt en beëindig de levenscyclus met mtx_destroy.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init slaat de identificatie van een nieuwe mutex op in het mtx_t-object waarnaar mtx verwijst. De functie retourneert thrd_success of thrd_error. Gebruik het object na een fout niet als een geïnitialiseerde mutex.
type moet een van deze vier waarden zijn: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. De eerste twee staan voor niet-recursieve mutexen; mtx_recursive staat hetzelfde thread toe de mutex herhaaldelijk te vergrendelen, en mtx_timed ondersteunt tijdslimieten.
Initialiseer de mutex voordat je die met andere threads deelt. Initialiseer een actieve mutex niet opnieuw. Roep na gebruik mtx_destroy aan; op dat moment mag geen enkele thread op die mutex wachten.
Ondersteuning voor <threads.h> is optioneel; als __STDC_NO_THREADS__ gelijk is aan 1, ontbreekt die ondersteuning. De C23-vlag van de repository bevestigt niet dat de runtimebibliotheek in productie beschikbaar is.
Voorbeelden
#include <stdio.h>
#include <stdlib.h>
#if defined(__STDC_NO_THREADS__) && __STDC_NO_THREADS__ == 1
#error "Threads support required"
#else
#include <threads.h>
int main(void)
{
mtx_t mutex;
if (mtx_init(&mutex, mtx_plain) != thrd_success) {
fputs("mtx_init failed\n", stderr);
return EXIT_FAILURE;
}
mtx_destroy(&mutex);
puts("OK");
return EXIT_SUCCESS;
}
#endif
Resultaat
OK
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.