pcntl_getpriority

(PHP 5, PHP 7, PHP 8)

pcntl_getpriorityObtém a prioridade de um processo

Descrição

pcntl_getpriority(?int $process_id = null, int $mode = PRIO_PROCESS): int|false

pcntl_getpriority() obtém a prioridade de process_id. Como os níveis de prioridade podem mudar dependendo do tipo do sistema e das versões de kernel, consulte o manual de getpriority(2) do sistema em uso para detalhes específicos.

Parâmetros

process_id

Se null, o ID do processo atual é usado.

mode

Uma das constantes PRIO_PGRP, PRIO_USER, PRIO_PROCESS, PRIO_DARWIN_BG ou PRIO_DARWIN_THREAD.

Valor Retornado

pcntl_getpriority() retorna a prioridade do processo ou false em caso de erro. Um valor numérico menor dá maior prioridade no processo.

Aviso

Esta função pode retornar o valor booleano false, mas também pode retornar um valor não booleano que pode ser avaliado como false. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.

Registro de Alterações

Versão Descrição
8.0.0 process_id agora pode ser nulo.

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 1 note

up
2
jonathan at jcdesigns dot com
16 years ago
This function is ideal for checking if a given process is running, I have seen solutions that involve running the system utilites like PS and parsing the answer, which should work fine, but this allows you to check a given PID with a single call

function CheckPID( $PID )
{
// Check if the passed in PID represents a vlaid process in the system
// Returns true if it does
// Turn off non-fatal runtime warning for a moment as we know we
// will get one if the PID does not represent a valid process

$oldErrorLevel = error_reporting(0);
error_reporting( $oldErrorLevel & ~E_WARNING );
$res = pcntl_getpriority($PID);
error_reporting( $oldErrorLevel);
return ! ( $res === false);
}
To Top