tss_create

 

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>
int tss_create( tss_t* tss_key, tss_dtor_t destructor );		(seit C11)

Erstellt einen neuen Key für Thread-spezifischen Speicher und speichert ihn in dem Objekt, auf das von tss_key gezeigt wird. Obwohl derselbe Key-Wert von verschiedenen Threads verwendet werden kann, werden die Werte, die mit dem Key durch tss_set gebunden sind, auf Pro-Thread-Basis verwaltet und bleiben für die Lebensdauer des aufrufenden Threads bestehen.

Der Wert NULL wird mit dem neu erstellten Key in allen vorhandenen Threads assoziiert, und bei der Thread-Erstellung werden die mit allen TSS-Keys assoziierten Werte auf NULL initialisiert.

Wenn destructor kein Nullzeiger ist, wird auch der Destruktor assoziiert, der aufgerufen wird, wenn der Speicher von thrd_exit freigegeben wird (aber nicht von tss_delete und nicht bei Programmbeendigung durch exit).

Ein Aufruf von tss_create innerhalb eines Destruktors für Thread-spezifischen Speicher führt zu undefiniertem Verhalten.

Parameter

tss_key	-	Zeiger auf den Speicherort, an dem der neue Key für Thread-spezifischen Speicher gespeichert werden soll
Destruktor	-	Zeiger auf eine Funktion, die beim Beenden des Threads aufgerufen werden soll

Anmerkungen

Das POSIX-Äquivalent dieser Funktion ist pthread_key_create.

Rückgabewert

thrd_success bei Erfolg, thrd_error andernfalls.

Beispiel

int thread_func(void *arg) {
    tss_t key;
    if (thrd_success == tss_create(&key, free)) {
        tss_set(key, malloc(4)); // stores a pointer on TSS
        // ...
    }
} // calls free() for the pointer stored on TSS

Referenzen

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

• 7.26.6.1 The tss_create function (S. 281-282)

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

• 7.26.6.1 The tss_create function (S. 386)