CKTIS / C
mtx_init — inicializar un mutex
mtx_init de <threads.h> inicializa un mutex con las propiedades elegidas. Comprueba el resultado antes de usar el objeto y finaliza su ciclo de vida con mtx_destroy.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init almacena el identificador de un nuevo mutex en el objeto mtx_t al que apunta mtx. La función devuelve thrd_success o thrd_error. Si falla, no uses el objeto como si fuera un mutex inicializado.
type debe ser uno de estos cuatro valores: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Los dos primeros representan mutexes no recursivos; mtx_recursive permite que el mismo hilo bloquee el mutex repetidamente, y mtx_timed admite límites de tiempo.
Inicializa el mutex antes de compartirlo con otros hilos. No vuelvas a inicializar un mutex activo. Cuando termines de usarlo, llama a mtx_destroy; en ese momento ningún hilo debe estar esperando ese mutex.
La compatibilidad con <threads.h> es opcional; si __STDC_NO_THREADS__ vale 1, significa que no está disponible. La opción C23 del repositorio no garantiza que la biblioteca de ejecución esté disponible en producción.
Ejemplos
#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
Resultado
OK
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.