CKTIS / C
tss_get — čítanie ukazovateľa špecifického pre vlákno
tss_get číta ukazovateľ uložený pod kľúčom úložiska špecifického pre vlákno, a to pre vlákno, ktoré funkciu volá.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
void *tss_get(tss_t key);tss_get(key) z <threads.h> vracia priradený void * vlákna, ktoré funkciu volá. Rovnaký kľúč môže v rôznych vláknach obsahovať rôzne ukazovatele.
Počiatočná hodnota je NULL; mení ju tss_set. Nulový výsledok označuje aj zlyhanie, takže nemožno rozlíšiť uložené NULL od zlyhania.
Kľúč musí pochádzať z úspešného volania tss_create, ktoré prebehlo predtým, ako vlákno začalo vykonávať deštruktory. Po tss_delete ho nepoužívajte. Čítanie nekopíruje ukazovaný objekt: zabezpečte správu jeho životnosti. tss_delete jeho deštruktor nevolá.
Príklady
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>
int main(void)
{
tss_t key;
int value = 42;
if (tss_create(&key, NULL) != thrd_success)
return EXIT_FAILURE;
printf("initial_null=%d\n", tss_get(key) == NULL);
if (tss_set(key, &value) != thrd_success) {
tss_delete(key);
return EXIT_FAILURE;
}
int *p = tss_get(key);
if (p != &value) {
tss_delete(key);
return EXIT_FAILURE;
}
printf("value=%d\n", *p);
tss_delete(key);
return EXIT_SUCCESS;
}
Výsledok
initial_null=1 value=42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.