com_message_pump

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

com_message_pumpОбработка сообщений COM, пришедших не позднее timeoutms миллисекунд послее ее запуска

Описание

com_message_pump ( int $timeout_milliseconds = 0 ) : bool

Функция "засыпает" на timeout_milliseconds миллисекунд, либо пока в очередь не придет новое сообщение.

Назначение функции состоит в маршрутизации вызовов COM между подразделениями и обработке различных асинхронных задач. Она позволит вашему скрипту ожидать возникновения события, одновременно с этим перехватывая другие события или выполняя другой код в фоне. Вы должны использовать ее в цикле, как показано в примере функции com_event_sink() до момента прекращения использования привязки событий объекта COM.

Список параметров

timeout_milliseconds

Задержка в миллисекундах.

Если значение timeout_milliseconds не задано, то оно будет считаться равным нулю. Это означает, что задержки не будет. Если при этом присутствует ожидающее событие, то оно будет обработано как обычно. Если события нет, то функция сразу же вернет false.

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

Если сообщения пришли до исчерпания задержки, то они будут обработаны и функция вернет true. Если время задержки вышло и ни одного сообщения не пришло, то функция вернет false.