Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

tss_create — tworzenie klucza danych lokalnych dla wątku

tss_create tworzy klucz do przechowywania osobnej wartości wskaźnika w każdym wątku. Sprawdź wynik przed użyciem klucza i zaplanuj zwalnianie zasobów.

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

Składnia

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

tss_create z <threads.h> zapisuje klucz w obiekcie tss_t wskazanym przez key. Jeden klucz identyfikuje osobną wartość wskaźnika dla każdego wątku; początkowo jest ona równa null, także w nowo tworzonych wątkach.

Sukces oznacza thrd_success. Przy thrd_error reprezentacja klucza jest nieokreślona: nie używaj go ani nie przekazuj do tss_delete.

dtor może być NULL. tss_delete nie wywołuje destruktora, a zakończenie programu również nie uruchamia destruktorów TSS. Nie wywołuj tss_create z destruktora.

Przykład używa tss_set i tss_get w bieżącym wątku; nie tworzy nowego wątku. Wskazywany obiekt pozostaje ważny aż do usunięcia klucza. Flaga kompilatora C23 nie potwierdza dostępności biblioteki wątków ani działania środowiska produkcyjnego.

Przykłady

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

Wynik

42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła