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.