com_message_pump
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
com_message_pump — Обработка сообщений COM, пришедших не позднее timeoutms миллисекунд послее ее запуска
Описание
$timeout_milliseconds
= 0
) : bool
Функция "засыпает" на timeout_milliseconds
миллисекунд, либо
пока в очередь не придет новое сообщение.
Назначение функции состоит в маршрутизации вызовов COM между подразделениями и обработке различных асинхронных задач. Она позволит вашему скрипту ожидать возникновения события, одновременно с этим перехватывая другие события или выполняя другой код в фоне. Вы должны использовать ее в цикле, как показано в примере функции com_event_sink() до момента прекращения использования привязки событий объекта COM.
Список параметров
-
timeout_milliseconds
-
Задержка в миллисекундах.
Если значение
timeout_milliseconds
не задано, то оно будет считаться равным нулю. Это означает, что задержки не будет. Если при этом присутствует ожидающее событие, то оно будет обработано как обычно. Если события нет, то функция сразу же вернетfalse
.
Возвращаемые значения
Если сообщения пришли до исчерпания задержки, то они будут обработаны
и функция вернет true
. Если время задержки вышло и ни одного сообщения не пришло,
то функция вернет false
.