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

# pcntl_strerror

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

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

### 説明

function pcntl_strerror(int `$error_code`): string

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() - 直近の pcntl 関数が失敗したときのエラー番号を取得する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open