Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

tss_set — ustawianie wskaźnika lokalnego dla wątku

tss_set zapisuje wskaźnik pod kluczem pamięci specyficznej dla bieżącego wątku i zwraca status operacji.

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

Składnia

#include <threads.h>
int tss_set(tss_t key, void *val);

tss_set(key, val) z <threads.h> zmienia wartość tylko dla bieżącego wątku. Zapisuje wskaźnik, nie kopię wskazywanego obiektu; obiekt musi pozostawać dostępny podczas używania wskaźnika.

Użyj prawidłowego klucza utworzonego przez udane tss_create, przed rozpoczęciem wykonywania destruktorów wątku. Wynikiem jest thrd_success albo thrd_error. NULL może być zapisaną wartością.

Zastąpienie wartości nie wywołuje destruktora poprzedniej wartości. Zarządzaj jej zasobami osobno. tss_delete także nie wywołuje destruktora.

Przykład używa tylko wątku głównego; lokalna zmienna żyje wystarczająco długo. Tryb kompilacji C23 nie potwierdza dostępności biblioteki wątków ani działania produkcyjnego środowiska wykonawczego.

Przykłady

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

int main(void)
{
    tss_t key;
    int value = 42;

    if (tss_create(&key, NULL) != thrd_success)
        return EXIT_FAILURE;

    if (tss_set(key, &value) != thrd_success) {
        tss_delete(key);
        return EXIT_FAILURE;
    }

    int *stored = tss_get(key);
    if (stored != &value) {
        tss_delete(key);
        return EXIT_FAILURE;
    }

    printf("%d\n", *stored);
    tss_delete(key);
    return EXIT_SUCCESS;
}

Wynik

42

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

Źródła