timer_gettime()

Получить оставшееся время работы таймера

Прототип:

#include <time.h>
                                       
int timer_gettime( timer_t timerid,
                   struct itimerspec *value );

Аргументы:

timerid: Объект типа timer_t, полученный при вызове функции timer_create(), и содержащий идентификатор таймера.
value: Указатель на структуру struct itimerspec, в которую функция запишет оставшееся время работы таймера.

Функция timer_gettime() получает значение времени, оставшееся до срабатывания таймера, а также значение периода срабатывания таймера, и сохраняет их в структуре, на которую указывает параметр value.

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

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

Коды ошибок:

EINVAL: Таймер с идентификатором timerid не связан с вызывающим процессом.

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

POSIX 1003.1 Timers

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

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

struct itimerspec, clock_getres(), clock_gettime(), clock_settime(), nanosleep(), sleep(), timer_t, timer_create(), timer_delete(), timer_getexpstatus(), timer_getoverrun(), timer_settime(), struct timespec

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