timer_getoverrun()

Получить значение счетчика переполнений таймера

Прототип:

#include <signal.h>
#include <time.h>
                                       
int timer_getoverrun( timer_t timerid );

Аргументы:

timerid
Объект типа timer_t, полученный при вызове функции timer_create(), и содержащий идентификатор таймера.

Библиотека:

libc

Описание:

Функция timer_getoverrun() возвращает значение счетчика переполнений для таймера с идентификатором timerid после получения сигнала об истечении времени срабатывания таймера.

В очередь для процесса находится только один сигнал в каждый момент времени. Если истекает время таймера с ожидающим сигналом, новый сигнал не ставится в очередь и происходит переполнение таймера.

Note: В отличии от сигналов пульсы могут накапливаться в очереди, поэтому переполнение возможно только для таймеров с типом уведомления сигнал.

Значение счетчика переполнений - это количество срабатываний таймера, произошедших между моментом, когда сигнал был поставлен в очередь и когда он был доставлен процессу, не превышающее значение DELAYTIMER_MAX. В случае, если количество переполнений превысило значение DELAYTIMER_MAX, то значение счетчика устанавливается в DELAYTIMER_MAX.

Возвращаемое функцией timer_getoverrun() значение применяется к самому последнему сигналу об истечения времени указанного таймера. В случае, если сигнал об истечения времени таймера не был доставлен, значение счетчика устанавливается равным 0.

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

The number of overruns.

Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EINVAL
Некорректный идентификатор timerid.

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

POSIX 1003.1 Timers

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

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

timer_t, timer_create(), timer_delete(), timer_getexpstatus(), timer_gettime(), timer_settime(), TimerInfo()




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