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

CKTIS / C

tss_get — leer un puntero específico del hilo

tss_get lee el puntero almacenado bajo una clave de almacenamiento específico del hilo para el hilo que realiza la llamada.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

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

tss_get(key) de <threads.h> devuelve el void * asociado al hilo que realiza la llamada. Una misma clave puede contener punteros distintos en diferentes hilos.

El valor inicial es NULL; tss_set lo cambia. Un resultado nulo también indica un fallo, por lo que no permite distinguir entre un NULL almacenado y un fallo.

La clave debe proceder de una llamada satisfactoria a tss_create, realizada antes de que el hilo empezara a ejecutar destructores. No la uses después de tss_delete. La lectura no copia el objeto apuntado: gestiona su duración. tss_delete no invoca su destructor.

Ejemplos

#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;
}

Resultado

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

Fuentes