Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori