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.