KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

tss_set — een threadspecifieke pointer instellen

tss_set slaat een pointer op onder een sleutel voor threadspecifieke opslag van de huidige thread en geeft een bewerkingsstatus terug.

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

Syntax

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

tss_set(key, val) uit <threads.h> verandert de waarde alleen voor de huidige thread. De functie slaat een pointer op, geen kopie van het aangewezen object; dat object moet beschikbaar blijven zolang de pointer wordt gebruikt.

Gebruik een geldige sleutel die is aangemaakt door een geslaagde aanroep van tss_create, voordat de thread destructors is gaan uitvoeren. Het resultaat is thrd_success of thrd_error. NULL is een toegestane opgeslagen waarde.

Bij het vervangen van een waarde wordt de destructor ervan niet aangeroepen. Beheer de bijbehorende resources afzonderlijk. Ook tss_delete roept geen destructors aan.

Het voorbeeld gebruikt alleen de hoofdthread; de lokale variabele blijft lang genoeg bestaan. De C23-compilatiemodus bevestigt niet dat de threadbibliotheek beschikbaar is of dat de runtime zich in een productieomgeving correct gedraagt.

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;

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

Resultaat

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