Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri