Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

tss_create — vytvoriť kľúč pre úložisko špecifické pre vlákno

tss_create vytvorí kľúč, ktorý každému vláknu umožňuje uchovávať vlastnú hodnotu ukazovateľa. Pred použitím kľúča skontrolujte výsledok a naplánujte uvoľnenie prostriedkov.

Verzia: C23; repository compiler flag, production runtime not attested

Syntax

#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);

Funkcia tss_create z <threads.h> zapíše kľúč do objektu tss_t, na ktorý ukazuje key. Jeden kľúč určuje samostatnú hodnotu ukazovateľa pre každé vlákno; na začiatku je táto hodnota nulová, a to aj v novo vytvorených vláknach.

Pri úspechu vráti thrd_success. Pri thrd_error je reprezentácia kľúča neurčitá: nepoužívajte ho ani ho neodovzdávajte funkcii tss_delete.

dtor môže byť NULL. tss_delete deštruktor nevolá a deštruktory TSS sa nevolajú ani pri ukončení programu. Nevolajte tss_create z deštruktora.

Príklad používa tss_set a tss_get v aktuálnom vlákne; nevytvára žiadne nové vlákno. Ukazovaný objekt zostáva platný až do odstránenia kľúča. Príznak prekladača pre C23 nedokladá dostupnosť knižnice vlákien ani nezaručuje správanie behového prostredia v produkcii.

Príklady

#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;
}

Výsledok

42

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje