WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

tss_create — einen Schlüssel für threadspezifischen Speicher erstellen

tss_create erstellt einen Schlüssel, über den jeder Thread einen eigenen Zeigerwert speichern kann. Prüfen Sie das Ergebnis, bevor Sie den Schlüssel verwenden, und planen Sie, wie Ressourcen freigegeben werden.

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

Syntax

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

tss_create aus <threads.h> schreibt einen Schlüssel in das von key angegebene Objekt vom Typ tss_t. Ein Schlüssel identifiziert für jeden Thread einen eigenen Zeigerwert; anfangs ist dieser Wert null, auch in neu erstellten Threads.

Bei Erfolg wird thrd_success zurückgegeben. Bei thrd_error ist die Darstellung des Schlüssels unbestimmt: Verwenden Sie ihn nicht und übergeben Sie ihn nicht an tss_delete.

dtor darf NULL sein. tss_delete ruft den Destruktor nicht auf, und auch beim Beenden des Programms werden keine TSS-Destruktoren aufgerufen. Rufen Sie tss_create nicht aus einem Destruktor auf.

Das Beispiel verwendet tss_set und tss_get im aktuellen Thread; es erstellt keinen neuen Thread. Das referenzierte Objekt bleibt gültig, bis der Schlüssel gelöscht wird. Ein C23-Compiler-Flag belegt weder die Verfügbarkeit der Thread-Bibliothek noch das Laufzeitverhalten in einer Produktionsumgebung.

Beispiele

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

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