CKTIS / C
tss_create — vytvoriť kľúč pre úložisko špecifické pre vlákno
tss_create vytvorí kľúč, ktorý každému vláknu umožňuje uchovávať vlastnú hodnotu ukazovateľa. Pred použitím kľúča skontrolujte výsledok a naplánujte uvoľnenie prostriedkov.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);Funkcia tss_create z <threads.h> zapíše kľúč do objektu tss_t, na ktorý ukazuje key. Jeden kľúč určuje samostatnú hodnotu ukazovateľa pre každé vlákno; na začiatku je táto hodnota nulová, a to aj v novo vytvorených vláknach.
Pri úspechu vráti thrd_success. Pri thrd_error je reprezentácia kľúča neurčitá: nepoužívajte ho ani ho neodovzdávajte funkcii tss_delete.
dtor môže byť NULL. tss_delete deštruktor nevolá a deštruktory TSS sa nevolajú ani pri ukončení programu. Nevolajte tss_create z deštruktora.
Príklad používa tss_set a tss_get v aktuálnom vlákne; nevytvára žiadne nové vlákno. Ukazovaný objekt zostáva platný až do odstránenia kľúča. Príznak prekladača pre C23 nedokladá dostupnosť knižnice vlákien ani nezaručuje správanie behového prostredia v produkcii.
Príklady
#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;
}Výsledok
42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.