basic_waitable_timer . Boost , Boost.Asio , Reference

basic_waitable_timer

Обеспечивает возможность ожидания функциональности таймера.

template<
    typename Clock,
    typename WaitTraits = boost::asio::wait_traits<Clock>,
    typename WaitableTimerService = waitable_timer_service<Clock, WaitTraits>>
class basic_waitable_timer :
  public basic_io_object< WaitableTimerService >

Types

Имя	Описание
час_type	Тип часов.
производство	Тип времени часов.
implementation_type	Основной тип реализации объекта I/O.
сервис_type	Тип сервиса, который будет использоваться для обеспечения операций I/O.
time_point	Тип времени часов.
traits_type	Тип признаков ожидания.

Member Functions

Имя	Описание
async_wait	Начните асинхронное ожидание на таймере.
basic_waitable_timer	Конструктор. Конструктор устанавливает определенное время истечения срока действия как абсолютное время. Конструктор должен установить определенное время истечения срока действия по отношению к настоящему времени.
сканировать	Отменить любые асинхронные операции, которые ждут на таймере.
cancel_one	Отменяет одну асинхронную операцию, которая ждет на таймере.
expires_at	Получить время истечения срока действия таймера как абсолютное время. Установите время истечения срока действия таймера как абсолютное время.
expires_from_now	Время истечения срока действия таймера по отношению к настоящему времени. Установите время истечения срока действия таймера по отношению к настоящему времени.
get_io_service	Получить io_сервис, связанный с объектом.
wait	Выполняйте блокирующее ожидание на таймере.

Protected Member Functions

Имя	Описание
get_implementation	Получить основную реализацию объекта I/O.
get_service	Получить услугу, связанную с объектом I/O.

Protected Data Members

Имя	Описание
осуществление	(Deprecated: Use get_implementation().) The underlying implementation of the I/O object.
сервис	(Deprecated: Use get_service(). Сервис, связанный с объектом I/O.

Шаблон класса basic_waitable_timer предоставляет возможность выполнять блокировку или асинхронное ожидание истечения срока действия таймера.

Ожидаемый таймер всегда находится в одном из двух состояний: «выжил» или «не истек». Если функция wait() или async_wait() называется на просроченном таймере, операция ожидания будет завершена немедленно.

В большинстве приложений будет использоваться один из steady_timer, система_timer или хай_разрешение_таймер Типdefs.

Remarks

Эта подходящая функция таймера предназначена для использования с C++11 стандартной библиотекой <chrono> или с Boost. Библиотека Хроно.

Thread Safety

Distinct объекты: Безопасно.

Составлено объекты: Небезопасны.

Examples

Выполнение блокировки ожидания (C++11):

// Construct a timer without setting an expiry time.
boost::asio::steady_timer timer(io_service);
// Set an expiry time relative to now.
timer.expires_from_now(std::chrono::seconds(5));
// Wait for the timer to expire.
timer.wait();

Выполнение асинхронного ожидания (C++11):

void handler(const boost::system::error_code& error)
{
  if (!error)
  {
    // Timer expired.
  }
}
...
// Construct a timer with an absolute expiry time.
boost::asio::steady_timer timer(io_service,
    std::chrono::steady_clock::now() + std::chrono::seconds(60));
// Start an asynchronous wait.
timer.async_wait(handler);

Changing an active waitable timer's expiry time

Изменение времени истечения срока действия таймера во время ожидания асинхронного ожидания приводит к отмене этих операций ожидания. Для обеспечения того, чтобы действие, связанное с таймером, выполнялось только один раз, используйте что-то подобное:

void on_some_event()
{
  if (my_timer.expires_from_now(seconds(5)) > 0)
  {
    // We managed to cancel the timer. Start new asynchronous wait.
    my_timer.async_wait(on_timeout);
  }
  else
  {
    // Too late, timer has already expired!
  }
}
void on_timeout(const boost::system::error_code& e)
{
  if (e != boost::asio::error::operation_aborted)
  {
    // Timer was not cancelled, take necessary action.
  }
}

boost::asio::basic_waitable_timer::expires_from_now() функция отменяет любые ожидающие асинхронные ожидания и возвращает количество асинхронных ожидания, которые были отменены. Если он возвращает 0, то вы были слишком поздно, и официант уже был казнен или вскоре будет казнен. Если он возвращает 1, то официант был успешно отменен.
Если обработчик ожидания отменяется, то в нем содержится бульон::system::error_code значение boost::asio::error::operation_aborted.

Requirements

Здитель: >boost/asio/basic_waitable_timer.hpp

Заголовок: boost/asio.hpp

Статья basic_waitable_timer раздела Boost.Asio Reference может быть полезна для разработчиков на c++ и boost.