WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

tss_get — einen threadspezifischen Zeiger lesen

tss_get liest den Zeiger, der für den aufrufenden Thread unter einem Schlüssel für threadspezifischen Speicher abgelegt ist.

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

Syntax

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

tss_get(key) aus <threads.h> gibt den zugehörigen void * des aufrufenden Threads zurück. Derselbe Schlüssel kann in verschiedenen Threads unterschiedliche Zeiger enthalten.

Der Anfangswert ist NULL; tss_set ändert ihn. Ein Nullergebnis weist auch auf einen Fehler hin und kann daher nicht zwischen einem gespeicherten NULL und einem Fehler unterscheiden.

Der Schlüssel muss von einem erfolgreichen tss_create stammen, das ausgeführt wurde, bevor der Thread mit der Ausführung von Destruktoren begonnen hat. Verwende ihn nicht nach tss_delete. Beim Lesen wird das referenzierte Objekt nicht kopiert: Achte auf dessen Lebensdauer. tss_delete ruft den Destruktor nicht auf.

Beispiele

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

Ergebnis

initial_null=1
value=42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen