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

関連キーワード:

pcntl errno エラーメッセージ strerror code last wait 直近番号 message failed sigwaitinfo unshare 関連サンプル状況 status fwrite child processes 参考