KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

tss_get — een threadspecifieke aanwijzer lezen

tss_get leest de aanwijzer die voor de aanroepende thread is opgeslagen onder een sleutel voor threadspecifieke opslag.

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

Syntax

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

tss_get(key) uit <threads.h> geeft de bijbehorende void * van de aanroepende thread terug. Dezelfde sleutel kan in verschillende threads verschillende aanwijzers bevatten.

De beginwaarde is NULL; tss_set verandert deze. Een nulresultaat duidt ook op een fout en kan dus geen onderscheid maken tussen een opgeslagen NULL en een fout.

De sleutel moet afkomstig zijn van een geslaagde tss_create, uitgevoerd voordat de thread destructors begon uit te voeren. Gebruik de sleutel niet na tss_delete. Bij het lezen wordt het aangewezen object niet gekopieerd: beheer de levensduur ervan. tss_delete roept de destructor niet aan.

Voorbeelden

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

Resultaat

initial_null=1
value=42

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen