CKTIS / C
tss_get — branje kazalca, specifičnega za nit
tss_get prebere kazalec, shranjen pod ključem za shranjevanje, specifično za nit, za nit, ki funkcijo pokliče.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
void *tss_get(tss_t key);tss_get(key) iz <threads.h> vrne pripadajoči void * niti, ki funkcijo pokliče. Isti ključ lahko v različnih nitih vsebuje različne kazalce.
Začetna vrednost je NULL; spremeni jo tss_set. Ničelni rezultat pomeni tudi napako, zato ni mogoče razločiti med shranjeno vrednostjo NULL in napako.
Ključ mora izvirati iz uspešnega klica tss_create, opravljenega, preden je nit začela izvajati destruktorje. Po tss_delete ga ne uporabljajte. Branje ne kopira kazanega objekta: poskrbite za njegovo življenjsko dobo. tss_delete ne pokliče njegovega destruktorja.
Primeri
#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;
}
Rezultat
initial_null=1 value=42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.