Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

tss_set — définir un pointeur propre au thread

tss_set stocke un pointeur sous une clé de stockage propre au thread courant et renvoie un état d’opération.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <threads.h>
int tss_set(tss_t key, void *val);

tss_set(key, val) de <threads.h> modifie la valeur uniquement pour le thread courant. La fonction stocke un pointeur, et non une copie de l’objet pointé ; cet objet doit rester disponible tant que le pointeur est utilisé.

Utilisez une clé valide créée par un appel réussi à tss_create, avant que le thread ne commence à exécuter des destructeurs. Le résultat est thrd_success ou thrd_error. NULL est une valeur pouvant être stockée.

Le remplacement d’une valeur n’appelle pas son destructeur. Gérez ses ressources séparément. tss_delete n’appelle pas non plus les destructeurs.

L’exemple utilise uniquement le thread principal ; sa variable locale vit suffisamment longtemps. Le mode de compilation C23 ne garantit ni la disponibilité de la bibliothèque de threads ni le comportement d’un environnement d’exécution en production.

Exemples

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

int main(void)
{
    tss_t key;
    int value = 42;

    if (tss_create(&key, NULL) != thrd_success)
        return EXIT_FAILURE;

    if (tss_set(key, &value) != thrd_success) {
        tss_delete(key);
        return EXIT_FAILURE;
    }

    int *stored = tss_get(key);
    if (stored != &value) {
        tss_delete(key);
        return EXIT_FAILURE;
    }

    printf("%d\n", *stored);
    tss_delete(key);
    return EXIT_SUCCESS;
}

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.

Sources