CKTIS / C
timespec_get — obter a hora
timespec_get guarda a hora numa struct timespec. Verifique o valor devolvido antes de ler os campos; a representação em nanossegundos não garante uma resolução de nanossegundos.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <time.h>
int timespec_get(struct timespec *ts, int base);timespec_get de <time.h> guarda a hora no objeto apontado por ts. Passe o endereço de uma struct timespec modificável. Em caso de sucesso, devolve base; em caso de falha, devolve 0. Nesse caso, não leia os campos.
Com TIME_UTC, tv_sec contém os segundos desde uma época definida pela implementação, que não tem necessariamente de ser a época Unix. tv_nsec contém nanossegundos arredondados à resolução do relógio; a unidade não garante exatidão.
TIME_UTC não garante monotonicidade. A norma C23 não define TIME_MONOTONIC como base de tempo, nem sequer como base opcional. Uma implementação pode definir bases de tempo adicionais; a sua disponibilidade e o seu comportamento dependem da implementação.
Exemplos
#include <stdio.h>
#include <time.h>
int main(void)
{
struct timespec ts;
if (timespec_get(&ts, TIME_UTC) != TIME_UTC) {
puts("unavailable");
return 1;
}
puts(ts.tv_nsec >= 0 && ts.tv_nsec < 1000000000L
? "valid nanoseconds" : "invalid nanoseconds");
return 0;
}Resultado
valid nanoseconds
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.