diff --git a/reference/sem/functions/msg-get-queue.xml b/reference/sem/functions/msg-get-queue.xml index 97582c345..fe119c7dc 100644 --- a/reference/sem/functions/msg-get-queue.xml +++ b/reference/sem/functions/msg-get-queue.xml @@ -1,9 +1,9 @@ - + - + msg_get_queue Создание или подключение к очереди сообщений @@ -12,14 +12,14 @@ &reftitle.description; - resourcemsg_get_queue + SysvMessageQueuefalsemsg_get_queue intkey - intperms0666 + intpermissions0666 msg_get_queue возвращает идентификатор, который используется для доступа к очереди сообщений System V с указанным ключом key. - Первый вызов создаёт очередь сообщений с необязательными правами perms. + Первый вызов создаёт очередь сообщений с необязательными правами permissions. Второй и последующие вызовы msg_get_queue для того же key будут возвращать другие идентификаторы, однако все они будут ссылаться на одну и ту же очередь сообщений. @@ -39,11 +39,11 @@ - perms + permissions Права доступа к очереди. По умолчанию 0666. Если очередт сообщений уже существует, - параметр perms игнорируется. + параметр permissions игнорируется. @@ -54,11 +54,36 @@ &reftitle.returnvalues; - Возвращает дескриптор ресурса, который может быть использован для доступа к очереди - сообщений System V. + Возвращает экземпляр SysvMessageQueue, который может быть использован для доступа к очереди + сообщений System V, &return.falseforfailure;. + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + В случае успешного выполнения функция теперь возвращает экземпляр SysvMessageQueue; + ранее возвращался ресурс (resource). + + + + + + + + &reftitle.seealso; @@ -73,7 +98,6 @@ - + - - + msg_receive Получение сообщения из очереди сообщений @@ -13,18 +12,18 @@ &reftitle.description; boolmsg_receive - resourcequeue - intdesiredmsgtype - intmsgtype - intmaxsize + SysvMessageQueuequeue + intdesired_message_type + intreceived_message_type + intmax_message_size mixedmessage boolunserialize&true; intflags0 - interrorcode + interror_code&null; msg_receive получает первое сообщение из задаваемой параметром - queue очереди сообщений с типом, указанным в desiredmsgtype. + queue очереди сообщений с типом, указанным в desired_message_type. @@ -36,19 +35,19 @@ queue - Идентификатор ресурса очереди. + Очередь сообщений. - desiredmsgtype + desired_message_type - Если в desiredmsgtype указано 0, возвращается первое - сообщение из очереди. Если desiredmsgtype больше 0, то - возвращается первое сообщение с указанным типом. Если desiredmsgtype + Если в desired_message_type указано 0, возвращается первое + сообщение из очереди. Если desired_message_type больше 0, то + возвращается первое сообщение с указанным типом. Если desired_message_type меньше 0, то возвращается первое сообщение с типом, меньшим или равным по модулю - указанному в desiredmsgtype. Если нет сообщений, + указанному в desired_message_type. Если нет сообщений, соответствующих критериям, ваш скрипт ожидает их появления в очереди. Вы можете изменить это поведение, указав MSG_IPC_NOWAIT в параметре flags. @@ -56,7 +55,7 @@ - msgtype + received_message_type В этом параметре сохраняется тип полученного сообщения. @@ -64,10 +63,10 @@ - maxsize + max_message_size - Максимальный размер принимаемого сообщения задаётся в maxsize; + Максимальный размер принимаемого сообщения задаётся в max_message_size; если сообщение в очереди больше этого размера, то функция завершается ошибкой (если вы не установите flags как описано ниже). @@ -113,7 +112,7 @@ MSG_IPC_NOWAIT - Если нет сообщений, удовлетворяющих условиям desiredmsgtype, + Если нет сообщений, удовлетворяющих условиям desired_message_type, возвращаться немедленно, а не ждать. Функция завершается ошибкой и возвращает целочисленное значение MSG_ENOMSG. @@ -122,15 +121,15 @@ MSG_EXCEPT Использование этого флага в комбинации с указынным в - desiredmsgtype положительным значением, + desired_message_type положительным значением, позволяет получить первое сообщение, тип которого не равен значению - desiredmsgtype. + desired_message_type. MSG_NOERROR - Если размер сообщения превышает maxsize, - то установка этого флага приводит к усечению сообщения до maxsize + Если размер сообщения превышает max_message_size, + то установка этого флага приводит к усечению сообщения до max_message_size без сигнализирования об ошибке. @@ -141,10 +140,10 @@ - errorcode + error_code - Если функция завершается аварийно, необязательный параметр errorcode + Если функция завершается аварийно, необязательный параметр error_code будет содержать значение системной переменной errno. @@ -166,6 +165,31 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Параметр queue теперь ожидает экземпляр SysvMessageQueue; + ранее ожидался русурс (resource). + + + + + + + + &reftitle.seealso; @@ -179,7 +203,6 @@ - + - + msg_remove_queue Удаление очереди сообщений @@ -12,7 +12,7 @@ &reftitle.description; boolmsg_remove_queue - resourcequeue + SysvMessageQueuequeue msg_remove_queue удаляет очередь сообщений, указанную в @@ -30,7 +30,7 @@ queue - Дескриптор ресурса очереди сообщений + Очередь сообщений. @@ -44,6 +44,31 @@ &return.success; + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Параметр queue теперь ожидает экземпляр SysvMessageQueue; + ранее ожидался русурс (resource). + + + + + + + &reftitle.seealso; @@ -58,7 +83,6 @@ - + - - + msg_send Отправка сообщения в очередь сообщений @@ -13,16 +12,16 @@ &reftitle.description; boolmsg_send - resourcequeue - intmsgtype - mixedmessage + SysvMessageQueuequeue + intmessage_type + stringintfloatboolmessage boolserialize&true; boolblocking&true; - interrorcode + interror_code&null; msg_send отправляет сообщение message - с типом msgtype (должно быть больше 0) в очередь сообщений, + с типом message_type (должно быть больше 0) в очередь сообщений, указанную параметром queue. @@ -35,12 +34,12 @@ queue - Идентификатор ресурса очереди. + Очередь сообщений. - msgtype + message_type Тип сообщения. Должно быть больше 0. @@ -86,14 +85,14 @@ Это называется блокировкой; вы можете отключить эту возможность, установив для blocking значение &false;, в этом случае msg_send будет немедленно возвращать &false; если сообщение - слишком велико, и устанавливать необязательный параметр errorcode + слишком велико, и устанавливать необязательный параметр error_code в значение MSG_EAGAIN, что будет указывать вам на необходимость попробовать отправить сообщение несколько позже. - errorcode + error_code Если функция отработает неудачно, то этот код будет записан в системную переменную errno. @@ -117,6 +116,31 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Параметр queue теперь ожидает экземпляр SysvMessageQueue; + ранее ожидался русурс (resource). + + + + + + + + &reftitle.seealso; @@ -130,7 +154,6 @@ - + - + msg_set_queue Установка информации в структуре данных очереди сообщений @@ -12,7 +12,7 @@ &reftitle.description; boolmsg_set_queue - resourcequeue + SysvMessageQueuequeue arraydata @@ -36,7 +36,7 @@ queue - Дескриптор ресурса очереди сообщений. + Очередь сообщений. @@ -58,6 +58,31 @@ &return.success; + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Параметр queue теперь ожидает экземпляр SysvMessageQueue; + ранее ожидался русурс (resource). + + + + + + + &reftitle.seealso; @@ -72,7 +97,6 @@ - + - + msg_stat_queue Получение информации из структуры данных очереди сообщений @@ -11,8 +11,8 @@ &reftitle.description; - arraymsg_stat_queue - resourcequeue + arrayfalsemsg_stat_queue + SysvMessageQueuequeue msg_stat_queue возвращает мета-данные очереди сообщений, @@ -29,7 +29,7 @@ queue - Дескриптор ресурса очереди сообщений. + Очередь сообщений. @@ -40,7 +40,7 @@ &reftitle.returnvalues; - Возвращаемое значение является массивом, ключи и значения которого означают следующее: + В случае успешного выполнения возвращаемое значение представляет собой массив, ключи и значения которого означают следующее: Структура массива для msg_stat_queue @@ -111,6 +111,34 @@
+ + Возвращает &false; в случае возникновения ошибки. + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Параметр queue теперь ожидает экземпляр SysvMessageQueue; + ранее ожидался русурс (resource). + + + + + + @@ -126,7 +154,6 @@ - + - + sem_acquire Захват семафора @@ -12,8 +12,8 @@ &reftitle.description; boolsem_acquire - resourcesem_identifier - boolnowait&false; + SysvSemaphoresemaphore + boolnon_blocking&false; sem_acquire блокируется (при необходимости) до момента захвата @@ -31,15 +31,15 @@ - sem_identifier + semaphore - sem_identifier - это ресурс семафора, полученный из sem_get. + semaphore - семафор. - nowait + non_blocking Указывает, должен ли процесс ждать для захвата семафора. @@ -72,9 +72,10 @@ - 5.6.1 + 8.0.0 - Добавлен параметр $nowait. + Параметр semaphore теперь ожидает экземпляр SysvSemaphore; + ранее ожидался русурс (resource). @@ -94,7 +95,6 @@ - + - + sem_get Получение идентификатора семафора @@ -11,11 +11,11 @@ &reftitle.description; - resourcesem_get + SysvSemaphorefalsesem_get intkey intmax_acquire1 - intperm0666 - intauto_release1 + intpermissions0666 + boolauto_release&true; sem_get возвращает идентификатор, который может быть использован @@ -53,7 +53,7 @@ - perm + permissions Права доступа к семафору. В действительности, устанавливается только если процесс @@ -80,6 +80,38 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + В случае успешного выполнения функция возвращает экземпляр SysvSemaphore; + ранее возвращался ресурс (resource). + + + + 8.0.0 + + Тип auto_release изменен с + целого числа (int) на логическое значение (bool). + + + + + + + + &reftitle.notes; @@ -105,7 +137,6 @@ - + - + sem_release Освобождение семафора @@ -12,7 +12,7 @@ &reftitle.description; boolsem_release - resourcesem_identifier + SysvSemaphoresemaphore sem_release освобождает семафор, если он был захвачен вызывающим @@ -28,10 +28,10 @@ - sem_identifier + semaphore - Ресурс семафора, возвращённый sem_get. + Семафор, возвращённый sem_get. @@ -46,6 +46,31 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Параметр semaphore теперь ожидает экземпляр SysvSemaphore; + ранее ожидался русурс (resource). + + + + + + + + &reftitle.seealso; @@ -57,7 +82,6 @@ - + - + sem_remove Удаление семафора @@ -12,7 +12,7 @@ &reftitle.description; boolsem_remove - resourcesem_identifier + SysvSemaphoresemaphore sem_remove удаляет указанный семафор. @@ -27,10 +27,10 @@ - sem_identifier + semaphore - Идентификатор семафора, возвращённый sem_get. + Cемафор, возвращённый sem_get. @@ -45,6 +45,31 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + Параметр semaphore теперь ожидает экземпляр SysvSemaphore; + ранее ожидался русурс (resource). + + + + + + + + &reftitle.seealso; @@ -57,7 +82,6 @@ - - + - - + shm_attach Создаёт или открывает сегмент разделяемой памяти @@ -12,23 +11,23 @@ &reftitle.description; - resourceshm_attach + SysvSharedMemoryfalseshm_attach intkey - intmemsize - intperm0666 + intnullsize&null; + intpermissions0666 shm_attach возвращает идентификатор, который можно использовать для доступа к разделяемой памяти System V по заданному ключу key. Первый - вызов создаёт сегмент размером memsize и опциональными битами прав доступа - perm. + вызов создаёт сегмент размером size и опциональными битами прав доступа + permissions. Следующий вызов shm_attach с тем же ключём - key вернёт другой идентификатор, но они оба будут + key вернёт другой экземпляр SysvSharedMemory, но они оба будут указывать на один и тот же сегмент разделяемой памяти. - Параметры memsize и - perm будут проигнорированы. + Параметры size и + permissions будут проигнорированы. @@ -45,7 +44,7 @@ - memsize + size Размер памяти. Если не задан, то по умолчанию будет использоваться @@ -55,7 +54,7 @@ - perm + permissions Опциональные биты прав доступа. По умолчанию 0666. @@ -69,43 +68,37 @@ &reftitle.returnvalues; - Возвращает идентификатор разделяемой памяти. + Возвращает экземпляр SysvSharedMemory в случае усупешного выполнения, &return.falseforfailure;. - - &reftitle.notes; - - - До PHP 5.3.0. эта функция возвращала целое число. Что бы добиться - переносимости кода, можно использовать приведение к целому, таким образом: - - - - - -]]> - - - - + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + В случае успешного выполнения функция возвращает экземпляр SysvSharedMemory; + ранее возвращался ресурс (resource). + + + + 8.0.0 + + size теперь допускает значение null. + + + + + @@ -119,7 +112,6 @@ $id = (integer) $id; -