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.