WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

thrd_create — einen Thread erstellen

thrd_create startet func(arg) in einem neuen Thread und speichert dessen Kennung über thr. Der Aufruf liefert den Erstellungsstatus zurück, nicht das Ergebnis der Thread-Funktion.

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

Syntax

#include <threads.h>
int thrd_create(thrd_t *thr, thrd_start_t func, void *arg);

thrd_create aus <threads.h> erstellt einen Thread, der func(arg) ausführt. thr zeigt auf den Speicherplatz für dessen Kennung; func hat einen mit int (*)(void *) kompatiblen Typ. Übergeben wird der Zeiger arg, nicht eine Kopie des Objekts, auf das er zeigt.

Der Rückgabewert ist thrd_success, thrd_nomem oder thrd_error. Die Rückkehr aus func entspricht einem Aufruf von thrd_exit mit dem Rückgabewert der Funktion. Der Abschluss von thrd_create ist mit dem Beginn des neuen Threads synchronisiert; er bedeutet nicht, dass dessen Arbeit beendet ist.

Lass die Argumentdaten gültig, bis sie nicht mehr verwendet werden. Hole das Ergebnis mit thrd_join ab; wenn kein Warten nötig ist, veranlasse thrd_detach. Das Erstellen eines Threads allein schützt spätere nebenläufige Zugriffe auf gemeinsam genutzte Daten nicht.

Im Beispiel bleibt input während des Wartens gültig. Die erwartete Ausgabe setzt voraus, dass beide Operationen erfolgreich sind. Ein C23-Compiler-Flag im Repository bestätigt nicht, dass eine produktionsfähige Thread-Laufzeitumgebung verfügbar ist.

Beispiele

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

static int worker(void *arg)
{
    return *(const int *)arg + 1;
}

int main(void)
{
    thrd_t thread;
    static int input = 41;
    int result;

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

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

Ergebnis

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