Standardbibliothek-Header <threads.h> (C11)

 

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

 

Standard Library-Header

<assert.h> <complex.h> (C99) <ctype.h> <errno.h> <fenv.h> (C99) <float.h> <inttypes.h> (C99)     <iso646.h> (C95) <limits.h> <locale.h> <math.h>

<setjmp.h> <signal.h> <stdalign.h> (C11*) <stdarg.h> <stdatomic.h> (C11)     <stdbit.h> (C23) <stdbool.h> (C99*) <stdckdint.h> (C23) <stddef.h> <stdint.h> (C99) <stdio.h>

<stdlib.h> <stdmchar.h> (C29) <stdnoreturn.h> (C11*) <string.h> <tgmath.h> (C99) <threads.h> (C11) <time.h> <uchar.h> (C11) <wchar.h> (C95) <wctype.h> (C95)

 

Dieser Header ist Teil der Bibliothek zur Unterstützung der Nebenläufigkeit und bietet Unterstützung für Threads, gegenseitigen Ausschluss, Bedingungsvariablen und threadspezifische Speicher.

Threads

thrd_t	implementierungsdefinierter vollständiger Objekttyp, der einen Thread identifiziert
thrd_create (C11)	erstellt einen Thread (Funktion)
thrd_equal (C11)	prüft, ob zwei Identifikatoren auf denselben Thread verweisen (Funktion)
thrd_current (C11)	holt den Identifikator des aktuellen Threads (Funktion)
thrd_sleep (C11)	setzt die Ausführung des aufrufenden Threads für die angegebene Zeitspanne aus (Funktion)
thrd_yield (C11)	gibt den aktuellen Zeitschlitz frei (Funktion)
thrd_exit (C11)	beendet den aufrufenden Thread (Funktion)
thrd_detach (C11)	trennt einen Thread ab (Funktion)
thrd_join (C11)	blockiert, bis ein Thread beendet wird (Funktion)
thrd_successthrd_timedoutthrd_busythrd_nomemthrd_error (C11)	zeigt einen Fehlerstatus eines Threads an (Konstante)
thrd_start_t (C11)	ein Typedef des Funktionszeigertyps int(*)(void*), verwendet von thrd_create (typedef)

Gegenseitiger Ausschluss

mtx_t	Mutex-Identifikator
mtx_init (C11)	erzeugt einen Mutex (Funktion)
mtx_lock (C11)	blockiert, bis ein Mutex gesperrt ist (Funktion)
mtx_timedlock (C11)	blockiert, bis ein Mutex gesperrt ist, oder läuft ab (Funktion)
mtx_trylock (C11)	sperrt einen Mutex oder kehrt zurück, ohne zu blockieren, wenn er bereits gesperrt ist (Funktion)
mtx_unlock (C11)	entsperrt einen Mutex (Funktion)
mtx_destroy (C11)	zerstört einen Mutex (Funktion)
mtx_plainmtx_recursivemtx_timed (C11)(C11)(C11)	definiert den Typ eines Mutex (enum)
Einmaliger Aufruf
call_once (C11)	ruft eine Funktion genau einmal auf (Funktion)

Bedingungsvariablen

cnd_t	Bedingungsvariablen-Identifikator
cnd_init (C11)	erstellt eine Bedingungsvariable (Funktion)
cnd_signal (C11)	entblockiert einen Thread, der auf eine Bedingungsvariable wartet (Funktion)
cnd_broadcast (C11)	entblockiert alle Threads, die auf eine Bedingungsvariable warten (Funktion)
cnd_wait (C11)	blockiert auf einer Bedingungsvariable (Funktion)
cnd_timedwait (C11)	blockiert auf einer Bedingungsvariable mit Timeout (Funktion)
cnd_destroy (C11)	zerstört eine Bedingungsvariable (Funktion)

Thread-lokaler Speicher

thread_local (C11)(entfernt in C23)	Komfortmakro für den Speicherklassenspezifizierer _Thread_local (Schlüsselwort-Makro)
tss_t	Thread-spezifischer Speicherzeiger
TSS_DTOR_ITERATIONS (C11)	maximale Anzahl von Aufrufen von Destruktoren (Makro-Konstante)
tss_dtor_t (C11)	Funktionszeigertyp void(*)(void*), verwendet für TSS-Destruktoren (typedef)
tss_create (C11)	erstellt einen Thread-spezifischen Speicherzeiger mit einem gegebenen Destruktor (Funktion)
tss_get (C11)	liest aus dem thread-spezifischen Speicher (Funktion)
tss_set (C11)	schreibt in den thread-spezifischen Speicher (Funktion)
tss_delete (C11)	gibt die Ressourcen frei, die von einem gegebenen thread-spezifischen Zeiger gehalten werden (Funktion)

Synopsis

#define __STDC_NO_THREADS__ 202311L
 
#define ONCE_FLAG_INIT      /* see description */
#define TSS_DTOR_ITERATIONS /* see description */
 
typedef /* see description */ cnd_t;
typedef /* see description */ thrd_t;
typedef /* see description */ tss_t;
typedef /* see description */ mtx_t;
typedef /* see description */ tss_dtor_t;
typedef /* see description */ thrd_start_t;
 
#define mtx_plain     /* see description */
#define mtx_recursive /* see description */
#define mtx_timed     /* see description */
#define once_flag     /* see description */
#define thrd_busy     /* see description */
#define thrd_error    /* see description */
#define thrd_nomem    /* see description */
#define thrd_success  /* see description */
#define thrd_timedout /* see description */
 
void call_once(once_flag* flag, void (*func)(void));
int cnd_broadcast(cnd_t* cond);
void cnd_destroy(cnd_t* cond);
int cnd_init(cnd_t* cond);
int cnd_signal(cnd_t* cond);
int cnd_timedwait(cnd_t* restrict cond, mtx_t* restrict mtx,
const struct timespec* restrict ts);
int cnd_wait(cnd_t* cond, mtx_t* mtx);
void mtx_destroy(mtx_t* mtx);
int mtx_init(mtx_t* mtx, int type);
int mtx_lock(mtx_t* mtx);
int mtx_timedlock(mtx_t* restrict mtx, const struct timespec* restrict ts);
int mtx_trylock(mtx_t* mtx);
int mtx_unlock(mtx_t* mtx);
int thrd_create(thrd_t* thr, thrd_start_t func, void* arg);
thrd_t thrd_current(void);
int thrd_detach(thrd_t thr);
int thrd_equal(thrd_t thr0, thrd_t thr1);
[[noreturn]] void thrd_exit(int res);
int thrd_join(thrd_t thr, int* res);
int thrd_sleep(const struct timespec* duration, struct timespec* remaining);
void thrd_yield(void);
int tss_create(tss_t* key, tss_dtor_t dtor);
void tss_delete(tss_t key);
void* tss_get(tss_t key);
int tss_set(tss_t key, void* val);