pcntl_get_last_error

直近の pcntl 関数が失敗したときのエラー番号を取得する

説明

int pcntl_get_last_error()

pcntl 関数が直近に失敗した際に設定されたエラー番号(errno) を取得します。エラー番号に関連付けられたシステムエラーメッセージは、 pcntl_strerror を使うとチェックできます。

パラメータ

この関数にはパラメータはありません。

戻り値

pcntl 関数が直近に失敗した際に設定されたエラー番号(errno) を取得します。エラーがない場合は、0 を返します。

例

例1 pcntl_get_last_error の例

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

<?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_strerror