Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes