CKTIS / C
tss_create — créer une clé de stockage spécifique à un thread
tss_create crée une clé permettant à chaque thread de conserver sa propre valeur de pointeur. Vérifiez le résultat avant d’utiliser la clé et prévoyez la libération des ressources.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);tss_create, défini dans <threads.h>, écrit une clé dans l’objet tss_t désigné par key. Une clé identifie une valeur de pointeur distincte pour chaque thread ; cette valeur est initialement nulle, y compris dans les threads nouvellement créés.
En cas de succès, la fonction renvoie thrd_success. Avec thrd_error, la représentation de la clé est indéterminée : ne l’utilisez pas et ne la transmettez pas à tss_delete.
dtor peut être NULL. tss_delete n’appelle pas le destructeur, et la fin du programme n’appelle pas non plus les destructeurs TSS. N’appelez pas tss_create depuis un destructeur.
L’exemple utilise tss_set et tss_get dans le thread courant ; il ne crée aucun nouveau thread. L’objet pointé reste valide jusqu’à la suppression de la clé. Une option de compilation C23 ne garantit ni la disponibilité de la bibliothèque de threads ni le comportement de l’environnement d’exécution en production.
Exemples
#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;
}Résultat
42
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.