gettimeofday()

Получить текущее системное время

Прототип:

#include <sys/time.h>
int gettimeofday( struct timeval *when,
void *not_used );

Аргументы:

when
Указатель на структуру struct timeval, в которой функция сохранит время.
not_used
Этот параметр должен быть равен NULL, иначе поведение функции gettimeofday() не определено. Данный аргумент нужен только для обратной совместимости.

Библиотека:

libc

Описание:

Функция gettimeofday() возвращает текущее время в секундах и микросекундах, начиная с т.н. "эпохи Unix" (00:00:00 1 января 1970 года по времени UTC/GMT).

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EFAULT
Возникла ошибка при доступе к буферу when.

Классификация:

POSIX 1003.1 XSI

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Предостережения:

Функция gettimeofday() предназначена для переноса (портирования) существующего кода. В новом коде вместо этой функции нужно использовать функцию clock_gettime().

Тематические ссылки:

time_t, struct timeval, asctime(), asctime_r(), clock_gettime(), clock_settime(), ctime(), ctime_r(), difftime(), gmtime(), gmtime_r(), localtime(), localtime_r(), settimeofday(), time()




Предыдущий раздел: Описание API системной библиотеки