Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

timespec_get — obtener la hora

timespec_get almacena la hora en una struct timespec. Compruebe el valor devuelto antes de leer los campos; la representación en nanosegundos no garantiza una resolución de nanosegundos.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <time.h>
int timespec_get(struct timespec *ts, int base);

timespec_get de <time.h> almacena la hora en el objeto al que apunta ts. Pase la dirección de una struct timespec modificable. Si tiene éxito, devuelve base; si falla, devuelve 0. En ese caso, no lea los campos.

Con TIME_UTC, tv_sec contiene los segundos desde una época definida por la implementación, que no tiene por qué ser la época Unix. tv_nsec contiene nanosegundos redondeados a la resolución del reloj; la unidad no garantiza exactitud.

TIME_UTC no garantiza la monotonía. C23 no define TIME_MONOTONIC como base de tiempo estándar, ni siquiera como opcional. Una implementación puede definir bases de tiempo adicionales; su disponibilidad y su comportamiento dependen de la implementación.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes