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 X/Open Systems Interfaces Extension

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Да

В потоке

Да

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

Функция 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 системной библиотеки