array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.msg-stat-queue.php', 1 => 'msg_stat_queue', 2 => 'Retorna informações da estrutura de dados da fila de mensagens', ), 'up' => array ( 0 => 'ref.sem.php', 1 => 'Funções de Semaphore', ), 'prev' => array ( 0 => 'function.msg-set-queue.php', 1 => 'msg_set_queue', ), 'next' => array ( 0 => 'function.sem-acquire.php', 1 => 'sem_acquire', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/sem/functions/msg-stat-queue.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

msg_stat_queue

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

msg_stat_queue — Retorna informações da estrutura de dados da fila de mensagens

Descrição

msg_stat_queue(SysvMessageQueue $queue): array|false

msg_stat_queue() retorna os metadados da fila de mensagens para a fila de mensagens especificada por queue. Isso é útil, por exemplo, para determinar qual processo enviou a mensagem que acabou de receber.

Parâmetros

queue
A fila de mensagens.

Valor Retornado

Em caso de sucesso, o valor de retorno é um array cujas chaves e valores têm os seguintes significados:
Array structure for msg_stat_queue
msg_perm.uid O uid do proprietário da fila.
msg_perm.gid O gid do proprietário da fila.
msg_perm.mode O modo de acesso ao arquivo da fila.
msg_stime O horário em que a última mensagem foi enviada para a fila.
msg_rtime O horário em que a última mensagem foi recebida da fila.
msg_ctime O horário em que a fila foi alterada pela última vez.
msg_qnum O número de mensagens aguardando para serem lidas na fila.
msg_qbytes O número máximo de bytes permitidos em uma fila de mensagens. No Linux, este valor pode ser lido e modificado via /proc/sys/kernel/msgmnb.
msg_lspid O pid do processo que enviou a última mensagem para a fila.
msg_lrpid O pid do processo que recebeu a última mensagem da fila.

Retorna false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 queue espera uma instância de SysvMessageQueue agora; anteriormente, um resource era esperado.

Veja Também