pcntl_strerror

指定した errno に対応するシステムのエラーメッセージを取得する

説明

string pcntl_strerror(int $error_code)

pcntl 関数が直近に失敗した際の、指定された error_code(errno) に関連付けられたシステムエラーメッセージを返します。 error_code は、 pcntl_get_last_error をコールすることで取得できます。

パラメータ

error_code: pcntl_get_last_error が返したエラー番号(errno)

戻り値

エラーメッセージを文字列で返します。

例

例1 pcntl_strerror の例

このサンプルは、子プロセスが存在しない状況で、子プロセスを待とうとします。それに対応するエラーメッセージを出力します。

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

上の例の出力は、たとえば以下のようになります。

pcntl_wait failed with errno 10: No child processes

参考

pcntl_get_last_error