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

CKTIS / C

tss_get — lire un pointeur spécifique au thread

tss_get lit le pointeur stocké sous une clé de stockage spécifique au thread pour le thread appelant.

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

Syntaxe

#include <threads.h>
void *tss_get(tss_t key);

tss_get(key) de <threads.h> renvoie le void * associé au thread appelant. Une même clé peut contenir des pointeurs différents dans différents threads.

La valeur initiale est NULL ; tss_set la modifie. Un résultat nul indique aussi un échec : il ne permet donc pas de distinguer un NULL stocké d’un échec.

La clé doit provenir d’un appel réussi à tss_create, effectué avant que le thread ne commence à exécuter des destructeurs. Ne l’utilisez pas après tss_delete. La lecture ne copie pas l’objet pointé : gérez sa durée de vie. tss_delete n’appelle pas son destructeur.

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;

    printf("initial_null=%d\n", tss_get(key) == NULL);

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

    int *p = tss_get(key);
    if (p != &value) {
        tss_delete(key);
        return EXIT_FAILURE;
    }
    printf("value=%d\n", *p);

    tss_delete(key);
    return EXIT_SUCCESS;
}

Résultat

initial_null=1
value=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