KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

tss_create — een sleutel voor thread-specifieke opslag maken

tss_create maakt een sleutel waarmee elke thread een eigen pointerwaarde kan bewaren. Controleer het resultaat voordat u de sleutel gebruikt en plan hoe u resources vrijgeeft.

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

Syntax

#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);

tss_create uit <threads.h> schrijft een sleutel naar het tss_t-object waar key naar verwijst. Eén sleutel identificeert voor elke thread een afzonderlijke pointerwaarde; aanvankelijk is die waarde null, ook in nieuw aangemaakte threads.

Bij succes retourneert de functie thrd_success. Bij thrd_error is de representatie van de sleutel onbepaald: gebruik de sleutel niet en geef hem niet door aan tss_delete.

dtor mag NULL zijn. tss_delete roept de destructor niet aan, en het beëindigen van het programma roept evenmin TSS-destructors aan. Roep tss_create niet aan vanuit een destructor.

Het voorbeeld gebruikt tss_set en tss_get in de huidige thread; het maakt geen nieuwe thread aan. Het aangewezen object blijft geldig totdat de sleutel wordt verwijderd. Een C23-compileroptie toont niet aan dat de threadbibliotheek beschikbaar is en garandeert niets over het runtimegedrag in productie.

Voorbeelden

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

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

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

    if (tss_get(key) != NULL) {
        tss_delete(key);
        return 2;
    }

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

    int *stored = tss_get(key);
    if (stored == NULL) {
        tss_delete(key);
        return 4;
    }

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

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