Name

ap_check_alarm — check alarm (Win32 only)

Synopsis

int ap_check_alarm(void)

Since Win32 has no alarm() function, it is necessary to check alarms “by hand.” This function does that, calling the alarm function set with one of the timeout functions. Returns -1 if the alarm has gone off, the number of seconds left before the alarm does go off, or 0 if no alarm is set.