П О Р Т А Л                            
С Е Т Е В Ы Х                          
П Р О Е К Т О В                        
  
Поиск по сайту:
                                                 
Главная

О проекте

Web-мастеру
     HTML & JavaScript
     SSI
     Perl
     PHP
     XML & XSLT
     Unix Shell

MySQL

Безопасность

Хостинг

Другое








Самое читаемое:

Учебник PHP - "Для Чайника".
Просмотров 550 раз(а).

Иллюстрированный самоучитель по созданию сайтов.
Просмотров 93949 раз(а).

Учебник HTML.
Просмотров 81772 раз(а).

Руководство по PHP5.
Просмотров 52098 раз(а).

Хостинг через призму DNS.
Просмотров 60719 раз(а).

Подборка текстов стандартных документов.
Просмотров 50703 раз(а).

Учебник PHP - Самоучитель
Просмотров 58040 раз(а).

Документация на MySQL (учебник & справочное руководство)
Просмотров 59536 раз(а).

Внешние атаки...
Просмотров 49209 раз(а).

Учебник PHP.
Просмотров 42561 раз(а).

SSI в примерах.
Просмотров 32825 раз(а).



 
 
| Добавить в избранное | Сделать стартовой | Помощь





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

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


Если Вы не нашли что искали, то рекомендую воспользоваться поиском по сайту: