array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.com-message-pump.php', 1 => 'com_message_pump', 2 => 'Обработка сообщений COM, пришедших не позднее timeoutms миллисекунд после её запуска', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'Функции COM', ), 'prev' => array ( 0 => 'function.com-load-typelib.php', 1 => 'com_load_typelib', ), 'next' => array ( 0 => 'function.com-print-typeinfo.php', 1 => 'com_print_typeinfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/com/functions/com-message-pump.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

com_message_pump

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

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.