WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

thrd_sleep — den aufrufenden Thread anhalten

thrd_sleep hält den aufrufenden Thread für eine angegebene Zeitspanne an. Ein Signal kann das Warten unterbrechen, und die Zeitplanung kann es verlängern.

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

Syntax

#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);

thrd_sleep aus <threads.h> erwartet eine Zeitspanne, keinen Zeitpunkt: duration zeigt auf eine struct timespec mit Sekunden in tv_sec und Nanosekunden in tv_nsec.

remaining darf NULL sein; bei einer Unterbrechung durch ein Signal erhält es die verbleibende Zeitspanne. Beide Zeiger dürfen auf dasselbe Objekt zeigen.

Der Rückgabewert 0 bedeutet, dass die angeforderte Zeitspanne abgelaufen ist. Unterbricht ein Signal das Warten, gibt die Funktion -1 zurück. Bei einem Fehler gibt sie einen negativen Wert zurück, der ebenfalls -1 sein kann. Aus -1 allein lässt sich daher nicht erkennen, ob ein Signal das Warten unterbrochen hat. Gehe nicht allein aufgrund dieses Werts davon aus, dass ein erneuter Aufruf sicher ist.

Ohne Unterbrechung ist die Wartezeit gemäß TIME_UTC nicht kürzer als angefordert, aber die Auflösung der Uhr und die Zeitplanung können sie verlängern.

Beispiele

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

int main(void)
{
    const struct timespec duration = {
        .tv_sec = 0,
        .tv_nsec = 10000000L
    };

    if (thrd_sleep(&duration, NULL) != 0) {
        fputs("Sleep did not complete.\n", stderr);
        return EXIT_FAILURE;
    }

    puts("Sleep completed.");
    return EXIT_SUCCESS;
}

Ergebnis

Sleep completed.

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