CKTIS / C
tss_create — ustvarjanje ključa za shrambo, specifično za nit
tss_create ustvari ključ, s katerim lahko vsaka nit hrani svojo vrednost kazalca. Pred uporabo ključa preverite rezultat in načrtujte sproščanje virov.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);tss_create iz <threads.h> zapiše ključ v objekt tss_t, na katerega kaže key. En ključ določa ločeno vrednost kazalca za vsako nit; sprva je ta vrednost ničelna, tudi v na novo ustvarjenih nitih.
Ob uspehu vrne thrd_success. Pri thrd_error je predstavitev ključa nedoločena: ne uporabljajte ga in ga ne posredujte funkciji tss_delete.
dtor je lahko NULL. tss_delete ne pokliče destruktorja, prav tako se destruktorji TSS ne pokličejo ob koncu programa. Funkcije tss_create ne kličite iz destruktorja.
Primer uporablja tss_set in tss_get v trenutni niti; ne ustvari nove niti. Kazani objekt ostane veljaven, dokler ključ ni izbrisan. Zastavica prevajalnika za C23 ne dokazuje, da je knjižnica niti na voljo, niti ne potrjuje delovanja izvajalnega okolja v produkciji.
Primeri
#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;
}Rezultat
42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.