WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

tss_set — einen threadspezifischen Zeiger setzen

tss_set speichert einen Zeiger unter einem Schlüssel für threadspezifischen Speicher des aktuellen Threads und gibt einen Operationsstatus zurück.

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

Syntax

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

tss_set(key, val) aus <threads.h> ändert den Wert nur für den aktuellen Thread. Gespeichert wird ein Zeiger, keine Kopie des referenzierten Objekts; dieses Objekt muss verfügbar bleiben, solange der Zeiger verwendet wird.

Verwenden Sie einen gültigen Schlüssel, der durch einen erfolgreichen Aufruf von tss_create erstellt wurde, bevor der Thread mit der Ausführung von Destruktoren begonnen hat. Das Ergebnis ist thrd_success oder thrd_error. NULL ist ein zulässiger gespeicherter Wert.

Beim Ersetzen eines Werts wird dessen Destruktor nicht aufgerufen. Verwalten Sie seine Ressourcen separat. Auch tss_delete ruft keine Destruktoren auf.

Das Beispiel verwendet nur den Hauptthread; seine lokale Variable lebt lange genug. Der C23-Kompilierungsmodus bestätigt weder die Verfügbarkeit der Thread-Bibliothek noch das Verhalten einer Laufzeitumgebung im Produktiveinsatz.

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;

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

Ergebnis

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