WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

thrd_exit — den aufrufenden Thread beenden

thrd_exit beendet den aufrufenden Thread und legt dessen int-Ergebnis fest, das mit thrd_join abgerufen werden kann.

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

Syntax

#include <threads.h>
[[noreturn]] void thrd_exit(int res);

thrd_exit(res) aus <threads.h> beendet den aktuellen Thread, ohne zurückzukehren. Das Argument res ist das Thread-Ergebnis und nicht der Prozess-Exitstatus; thrd_join ruft es ab. [[noreturn]] bedeutet, dass die Ausführung nicht zurückkehrt.

Vor dem Beenden werden die anwendbaren Destruktoren für threadspezifischen Speicher in nicht festgelegter Reihenfolge ausgeführt. Dies ersetzt nicht die ausdrückliche Freigabe anderer Ressourcen. Anders als exit beendet diese Funktion nicht sofort das gesamte Programm. Nach N3096 wird das Programm beim Beenden des letzten Threads so beendet, als wäre exit(EXIT_SUCCESS) aufgerufen worden.

Beispiele

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

static int worker(void *arg)
{
    (void)arg;
    thrd_exit(42);
}

int main(void)
{
    thrd_t thread;
    int result;

    if (thrd_create(&thread, worker, NULL) != thrd_success) {
        return EXIT_FAILURE;
    }
    if (thrd_join(thread, &result) != thrd_success) {
        return EXIT_FAILURE;
    }

    printf("result = %d\n", result);
    return EXIT_SUCCESS;
}

Ergebnis

result = 42

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