Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

tss_create — vytvořit klíč pro úložiště specifické pro vlákno

tss_create vytvoří klíč, který každému vláknu umožňuje uchovávat vlastní hodnotu ukazatele. Před použitím klíče zkontrolujte výsledek a naplánujte uvolnění prostředků.

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

Syntaxe

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

Funkce tss_create z <threads.h> zapíše klíč do objektu tss_t, na který ukazuje key. Jeden klíč určuje samostatnou hodnotu ukazatele pro každé vlákno; zpočátku je tato hodnota nulová, a to i v nově vytvořených vláknech.

Při úspěchu vrátí thrd_success. Při thrd_error je reprezentace klíče neurčitá: nepoužívejte jej ani jej nepředávejte funkci tss_delete.

dtor může být NULL. tss_delete destruktor nevolá a destruktory TSS se nevolají ani při ukončení programu. Nevolejte tss_create z destruktoru.

Příklad používá tss_set a tss_get v aktuálním vlákně; žádné nové vlákno nevytváří. Ukazovaný objekt zůstává platný až do odstranění klíče. Příznak překladače pro C23 nedokládá dostupnost knihovny vláken ani nezaručuje chování běhového prostředí v produkci.

Pří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ýsledek

42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje