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

CKTIS / C

tss_get — čtení ukazatele specifického pro vlákno

tss_get čte ukazatel uložený pod klíčem úložiště specifického pro vlákno, a to pro vlákno, které funkci volá.

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

Syntaxe

#include <threads.h>
void *tss_get(tss_t key);

tss_get(key) z <threads.h> vrací přidružený void * vlákna, které funkci volá. Stejný klíč může v různých vláknech obsahovat různé ukazatele.

Počáteční hodnota je NULL; mění ji tss_set. Nulový výsledek také označuje chybu, takže nelze rozlišit uložené NULL od chyby.

Klíč musí pocházet z úspěšného volání tss_create, které proběhlo předtím, než vlákno začalo vykonávat destruktory. Po tss_delete jej nepoužívejte. Čtení nekopíruje ukazovaný objekt: zajistěte správu jeho životnosti. tss_delete jeho destruktor nevolá.

Příklady

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

    printf("initial_null=%d\n", tss_get(key) == NULL);

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

    int *p = tss_get(key);
    if (p != &value) {
        tss_delete(key);
        return EXIT_FAILURE;
    }
    printf("value=%d\n", *p);

    tss_delete(key);
    return EXIT_SUCCESS;
}

Výsledek

initial_null=1
value=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