Новые книги
Битва за подписчика «ВКонтакте»: SMM-руководство
MDK, «Ты не поверишь!», «Корпорация зла» – эти сообщества известны каждому активному пользователю социальной сети в «ВКонтакте». У них миллионы пользователей и они приносят внушительные доходы своим создателям.

Как добиться такого же успеха, как продвигать свое интернет-сообщество, не повторяя чужих ошибок, как привлечь и удержать подписчиков, став гуру SMM-продвижения? Об этом рассказывает создатель легендарного сообщества «Литорг» Артем А. Сенаторов.
Управление отделом продаж
Ведущеее международное пособие! Самое актуальное издание классического учебника ? Марк Джонстон и Грэг Маршалл продолжают традиции мастерства, заложенные Черчиллем, Фордом и Уокером. Классика, полностью адаптированная к современной практике управления продажами.

В новом издании вас ожидают:

[ul]актуальный набор практических инструментов по управлению отделом продаж;

примеры из современной практики управления продажами;

разбор вопросов лидерства, технологий, инноваций, этики и глобального бизнеса;

разные подходы к коммуникации в сфере продаж.[/ul]

msg_receive
Версия для печати

Учебник РНР
Назад Вперёд

msg_receive

(только PHP 4 CVS)

msg_receive - получает сообщение из очереди сообщений.

Описание

bool msg_receive (int queue, int desiredmsgtype, int msgtype, int maxsize, mixed message [, bool unserialize [, int flags [, int errorcode]]])

msg_receive() получает первое сообщение из специфицированной очереди queue типа desiredmsgtype. Тип полученного сообщения будет храниться в msgtype. Максимальный размер принимаемого сообщения специфицируется параметром maxsize; если сообщение в очереди больше, чем этот размер, функция потерпит неудачу (если вы не установили flags, как описано ниже). Получаемое сообщение будет сохранено в message, если не было ошибок при получении сообщения - тогда в необязательный errorcode будет установлено значение системной переменной errno, что поможет вам идентифицировать причину.

Если desiredmsgtype равен 0, возвращается сообщение из начала очереди. Если desiredmsgtype больше 0, возвращается первое сообщение данного типа. Если desiredmsgtype меньше 0, будет прочитано первое сообщение в очереди с наименьшим типом, меньше и равным абсолютному значению desiredmsgtype. Если нет сообщений, соответствующих этому критерию, ваш скрипт будет ожидать, пока подходящее сообщение не дождётся своей очереди. Вы можете предотвратить блокировку скрипта, специфицировав MSG_IPC_NOWAIT в параметре flags.

unserialize имеет по умолчанию TRUE; если установлен TRUE, сообщение рассматривается как если бы оно было сериализовано с использованием того же механизма, что и в модуле сессии. Сообщение будет десериализовано и возвращено вашему скрипту. Это даёт возможность легко получать массивы или сложные структуры объектов их других PHP-скриптов или, если вы используете WDDX-сериализатор, из любого WDDX-совместимого источника. Если unserialize равен FALSE, сообщение будет возвращено как binary-safe строка.

Необязательный параметр flags даёт вам возможность передавать флаги низкоуровневому системному вызову msgrcv. По умолчанию равен 0, но вы можете специфицировать одно или более из следующих значений (складывая или OR'ируя их вместе).

Таблица 1. Значения флагов для msg_receive
MSG_IPC_NOWAITЕсли нет сообщений типа desiredmsgtype, возвращает немедленно и не ожидает. Функция терпит неудачу и возвращает integer-значение, соответствующее ENOMSG.
MSG_EXCEPTИспользование этого флага в сочетании с desiredmsgtype больше 0 заставляет функцию получать первое сообщение, которое не равно desiredmsgtype.
MSG_NOERRORЕсли сообщение длиннее maxsize, установка этого флага усекает сообщение до maxsize и не сигнализирует об ошибке.

При успешном выполнении структура данных очереди обновляется так:
msg_lrpid получает process-ID вызывающего процесса,
msg_qnum декрементирует на 1,
а в msg_rtime устанавливается текущее время.

msg_receive() возвращает TRUE при успехе, FALSE при неудаче. Если функция терпит неудачу, необязательный errorcode получит значение системной переменной errno.

См. также msg_remove_queue(), msg_send(), msg_stat_queue() и msg_set_queue().

Эта функция была введена в PHP 4.3.0.


Назад Оглавление Вперёд
msg_get_queue Вверхmsg_remove_queue