pcntl_strerror

(PHP 5 >= 5.3.4, PHP 7, PHP 8)

pcntl_strerror — Recupera a mensagem de erro do sistema associada ao número de erro fornecido

Descrição

pcntl_strerror(int $error_code): string

Retorna a mensagem de erro do sistema associada ao error_code fornecido (errno) da última função pcntl que falhou. O parâmetro error_code pode ser obtido chamando pcntl_get_last_error().

Parâmetros

error_code: Um número de erro (errno), retornado por pcntl_get_last_error().

Valor Retornado

Retorna a mensagem de erro, como uma string.

Exemplos

Exemplo #1 Exemplo de pcntl_strerror()

Este exemplo tentará aguardar processos filhos em uma situação onde não existe nenhum processo filho, e então exibirá a mensagem de erro correspondente.

<?php
$pid = pcntl_wait($status);
if ($pid === -1) {
    $errno = pcntl_get_last_error();
    $message = pcntl_strerror($errno);
    fwrite(STDERR, 'pcntl_wait falhou com errno ' . $errno
           . ': ' . $message . PHP_EOL);
}

O exemplo acima produzirá algo semelhante a:

pcntl_wait falhou com errno 10: No child processes

Veja Também

pcntl_get_last_error() - Recupera o número de erro definido pela última função pcntl que falhou