CKTIS / C
tss_create — stvaranje ključa za pohranu specifičnu za dretvu
tss_create stvara ključ koji svakoj dretvi omogućuje pohranu vlastite vrijednosti pokazivača. Provjerite rezultat prije uporabe ključa i isplanirajte oslobađanje resursa.
Verzija: 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> zapisuje ključ u objekt tss_t na koji pokazuje key. Jedan ključ označava zasebnu vrijednost pokazivača za svaku dretvu; početno je ta vrijednost nulta, uključujući i u novostvorenim dretvama.
U slučaju uspjeha vraća thrd_success. Uz thrd_error prikaz ključa nije određen: nemojte ga upotrebljavati ni prosljeđivati funkciji tss_delete.
dtor može biti NULL. tss_delete ne poziva destruktor, a ni završetak programa ne poziva TSS destruktore. Nemojte pozivati tss_create iz destruktora.
Primjer upotrebljava tss_set i tss_get u trenutačnoj dretvi; ne stvara novu dretvu. Objekt na koji pokazuje ostaje valjan dok se ključ ne izbriše. Oznaka prevoditelja za C23 ne dokazuje dostupnost biblioteke dretvi niti jamči ponašanje izvršnog okruženja u produkciji.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.