tss_set

 

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_set( tss_t tss_id, void *val );		(seit C11)

Setzt den Wert des Thread-spezifischen Speichers, der durch tss_id identifiziert wird, für den aktuellen Thread auf val. Unterschiedliche Threads können unterschiedliche Werte für denselben Schlüssel festlegen.

Der Destruktor, falls vorhanden, wird nicht aufgerufen.

Parameter

tss_id	-	Thread-spezifischer Speicherschlüssel, erhalten von tss_create und nicht gelöscht durch tss_delete
val	-	Wert, auf den der Thread-spezifische Speicher gesetzt werden soll

Rückgabewert

thrd_success bei Erfolg, thrd_error andernfalls.

Hinweise

Das POSIX-Äquivalent dieser Funktion ist pthread_setspecific.

Normalerweise wird TSS verwendet, um Zeiger auf Speicherblöcke zu speichern, die dynamisch zugewiesen und für die Verwendung durch den aufrufenden Thread reserviert wurden.

tss_set kann im TSS-Destruktor aufgerufen werden. Wenn der Destruktor mit einem Nicht-NULL-Wert im TSS-Speicher beendet wird, wird er von thrd_exit bis zu TSS_DTOR_ITERATIONS Mal wiederholt, danach geht der Speicher verloren.

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.4 Die Funktion tss_set (S. 282-283)

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

• 7.26.6.4 Die Funktion tss_set (S. 387)

Siehe auch

tss_get (C11)

liest aus dem thread-spezifischen Speicher (Funktion)