CKTIS / C
tss_create — crear una clave de almacenamiento específica de hilo
tss_create crea una clave que permite guardar un valor de puntero distinto para cada hilo. Comprueba el resultado antes de usar la clave y planifica cómo liberar los recursos.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);tss_create, de <threads.h>, escribe una clave en el objeto tss_t señalado por key. Una clave identifica un valor de puntero distinto para cada hilo; inicialmente ese valor es nulo, también en los hilos recién creados.
Si tiene éxito, devuelve thrd_success. Con thrd_error, la representación de la clave es indeterminada: no la uses ni la pases a tss_delete.
dtor puede ser NULL. tss_delete no invoca el destructor, y la terminación del programa tampoco invoca los destructores TSS. No llames a tss_create desde un destructor.
El ejemplo usa tss_set y tss_get en el hilo actual; no crea ningún hilo nuevo. El objeto señalado sigue siendo válido hasta que se elimina la clave. Una opción del compilador para C23 no demuestra que la biblioteca de hilos esté disponible ni acredita el comportamiento del entorno de ejecución en producción.
Ejemplos
#include <stdio.h>
#include <threads.h>
int main(void)
{
tss_t key;
int value = 42;
if (tss_create(&key, NULL) != thrd_success)
return 1;
if (tss_get(key) != NULL) {
tss_delete(key);
return 2;
}
if (tss_set(key, &value) != thrd_success) {
tss_delete(key);
return 3;
}
int *stored = tss_get(key);
if (stored == NULL) {
tss_delete(key);
return 4;
}
printf("%d\n", *stored);
tss_delete(key);
return 0;
}Resultado
42
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.