CKTIS / C
thrd_sleep — de aanroepende thread onderbreken
thrd_sleep onderbreekt de aanroepende thread gedurende de gevraagde tijdsduur. Een signaal kan het wachten onderbreken en de planning kan het verlengen.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int thrd_sleep(const struct timespec *duration, struct timespec *remaining);thrd_sleep uit <threads.h> neemt een tijdsduur aan, geen deadline: duration verwijst naar een struct timespec met seconden in tv_sec en nanoseconden in tv_nsec.
remaining mag NULL zijn; bij onderbreking door een signaal ontvangt deze de resterende tijdsduur. Beide pointers mogen naar hetzelfde object verwijzen.
Retourwaarde 0 betekent dat de gevraagde tijdsduur is verstreken. Als een signaal het wachten onderbreekt, geeft de functie -1 terug. Bij een fout geeft ze een negatieve waarde terug, die ook -1 kan zijn. Aan -1 alleen kun je dus niet zien of een signaal het wachten heeft onderbroken. Ga er niet op basis van die waarde alleen van uit dat je het veilig opnieuw kunt proberen.
Zonder onderbreking is de wachttijd volgens TIME_UTC niet korter dan gevraagd, maar de klokresolutie en planning kunnen deze verlengen.
Voorbeelden
#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;
}
Resultaat
Sleep completed.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.