База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

tss_create — създаване на ключ за специфично за нишка съхранение

tss_create създава ключ, чрез който всяка нишка може да съхранява собствена стойност на указател. Проверете резултата, преди да използвате ключа, и планирайте освобождаването на ресурсите.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

tss_create от <threads.h> записва ключ в обекта tss_t, посочен от key. Един ключ определя отделна стойност на указател за всяка нишка; първоначално стойността е нулева, включително в новосъздадените нишки.

При успех функцията връща thrd_success. При thrd_error представянето на ключа е неопределено: не го използвайте и не го подавайте на tss_delete.

dtor може да бъде NULL. tss_delete не извиква деструктора, а прекратяването на програмата също не извиква TSS деструктори. Не извиквайте tss_create от деструктор.

Примерът използва tss_set и tss_get в текущата нишка; не създава нова нишка. Посочваният обект остава валиден, докато ключът не бъде изтрит. Флаг на компилатора за C23 не доказва наличието на библиотеката за нишки и не удостоверява поведението на средата за изпълнение в продукция.

Примери

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

Резултат

42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници