Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes