WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

thrd_detach — einen Thread abkoppeln

thrd_detach aus <threads.h> sorgt dafür, dass die Ressourcen eines Threads nach dessen Beendigung freigegeben werden. Die Funktion wartet weder auf die Beendigung noch stoppt sie den Thread.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <threads.h>
int thrd_detach(thrd_t thr);

thrd_detach(thr) koppelt einen Thread ab: Seine Ressourcen werden nach seiner Beendigung freigegeben. Die Funktion gibt thrd_success zurück oder thrd_error, wenn die Anforderung nicht erfüllt werden kann.

Der Thread darf nicht bereits abgekoppelt oder mit thrd_join verbunden worden sein. Rufe nach erfolgreichem Abkoppeln für diesen Thread nicht thrd_join auf. Das Abkoppeln ersetzt weder die Synchronisierung noch die Verwaltung der Lebensdauer von Daten.

Das Beispiel beendet den Hauptthread mit thrd_exit(0), statt das Programm durch eine Rückkehr aus main zu beenden. Dadurch kann der Worker seine Arbeit abschließen. Die Unterstützung für <threads.h> ist optional; __STDC_NO_THREADS__ signalisiert, dass sie fehlt. Ein C23-Compiler-Flag bestätigt nicht, dass die Laufzeitbibliothek verfügbar ist.

Beispiele

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

static int worker(void *arg)
{
    (void)arg;
    puts("worker finished");
    return 0;
}

int main(void)
{
    thrd_t thread;
    if (thrd_create(&thread, worker, NULL) != thrd_success) {
        return EXIT_FAILURE;
    }

    if (thrd_detach(thread) != thrd_success) {
        (void)thrd_join(thread, NULL);
        return EXIT_FAILURE;
    }

    thrd_exit(0);
}

Ergebnis

worker finished

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.

Quellen