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.