tss_delete

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für nebenläufige Programmierung

Threads thrd_create thrd_equal thrd_current    thrd_sleep thrd_yield thrd_exit thrd_detach thrd_join thrd_successthrd_timedoutthrd_busythrd_nomemthrd_error    Atomare Operationen atomic_init ATOMIC_VAR_INIT (bis C23) ATOMIC_***_LOCK_FREE atomic_is_lock_free atomic_store atomic_load atomic_exchange atomic_compare_exchange atomic_fetch_add atomic_fetch_sub atomic_fetch_or atomic_fetch_xor atomic_fetch_and

Atomare Flags atomic_flag ATOMIC_FLAG_INIT atomic_flag_test_and_set atomic_flag_clear Speicherordnung memory_order kill_dependency atomic_thread_fence atomic_signal_fence Gegenseitiger Ausschluss mtx_init mtx_lock mtx_timedlock mtx_trylock call_once mtx_unlock mtx_destroy mtx_plainmtx_recursivemtx_timed Bedingungsvariablen cnd_init cnd_signal cnd_broadcast cnd_wait cnd_timedwait cnd_destroy Thread-lokaler Speicher thread_local TSS_DTOR_ITERATIONS    tss_create tss_get tss_set tss_delete

 

Definiert im Header <threads.h>
void tss_delete( tss_t tss_id );		(seit C11)

Zerstört den durch tss_id identifizierten Thread-spezifischen Speicher.

Der Destruktor, falls er von tss_create registriert wurde, wird nicht aufgerufen (er wird nur beim Beenden des Threads aufgerufen, entweder durch thrd_exit oder durch Rückgabe aus der Thread-Funktion). Es liegt in der Verantwortung des Programmierers sicherzustellen, dass jeder Thread, der von tss_id Kenntnis hat, alle notwendigen Bereinigungen durchgeführt hat, bevor der Aufruf von tss_delete erfolgt.

Wenn tss_delete aufgerufen wird, während ein anderer Thread Destruktoren für tss_id ausführt, ist es nicht spezifiziert, ob dies die Anzahl der Aufrufe des zugehörigen Destruktors ändert.

Wenn tss_delete aufgerufen wird, während der aufrufende Thread Destruktoren ausführt, wird der zu tss_id gehörende Destruktor auf diesem Thread nicht erneut ausgeführt.

Parameter

tss_id

-

Schlüssel für Thread-spezifischen Speicher, der zuvor von tss_create zurückgegeben wurde und noch nicht von tss_delete gelöscht wurde

Rückgabewert

(keine)

Hinweise

Das POSIX-Äquivalent dieser Funktion ist pthread_key_delete.

Der Grund, warum tss_delete niemals Destruktoren aufruft, ist, dass die Destruktoren (die beim Beenden des Threads aufgerufen werden) normalerweise von demselben Thread ausgeführt werden sollen, der den Wert ursprünglich gesetzt hat (über tss_set), mit dem der Destruktor umgeht, und sogar von den Werten dieses oder anderer Thread-spezifischer Daten abhängen können, wie sie von diesem Thread gesehen werden. Der Thread, der tss_delete ausführt, hat keinen Zugriff auf den TSS anderer Threads. Selbst wenn es möglich wäre, den Destruktor für den Wert jedes Threads, der mit tss_id verbunden ist, aufzurufen, müsste tss_delete mit jedem Thread synchronisieren, nur um zu prüfen, ob der Wert dieses TSS in diesem Thread null ist (Destruktoren werden nur für Nicht-Null-Werte aufgerufen).

Referenzen

• C17-Standard (ISO/IEC 9899:2018)

• 7.26.6.2 The tss_delete function (S. 282)

• C11-Standard (ISO/IEC 9899:2011)

• 7.26.6.2 The tss_delete function (S. 386)