pcntl-get-last-errorに追記

Author: jdkfx

reference/pcntl/functions/pcntl-get-last-error.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b608b323883ac77489a31f8a1aa406e17c202bcb Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 4ac5624be0dc8484a333514b605150e73cad06b8 Maintainer: takagi Status: ready -->
 
 <refentry xml:id="function.pcntl-get-last-error" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -15,11 +15,9 @@
    <void />
   </methodsynopsis>
   <para>
-
+   直前に失敗した pcntl 関数によって設定されたエラー番号 (<literal>errno</literal>) を取得します。
+   エラー番号に関連付けられたシステムエラーメッセージは、 <function>pcntl_strerror</function> を使用して確認できます。
   </para>
-
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -30,10 +28,38 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   エラーコードを返します。
+   直前に失敗した pcntl 関数によって設定されたエラー番号 (<literal>errno</literal>) を返します。エラーが発生していない場合は、 0 を返します。
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>pcntl_get_last_error</function> の例</title>
+   <para>
+    この例では、存在しない子プロセスを待機しようと試みた後、対応するエラーメッセージを出力します。
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$pid = pcntl_wait($status);
+if ($pid === -1) {
+    $errno = pcntl_get_last_error();
+    $message = pcntl_strerror($errno);
+    fwrite(STDERR, 'pcntl_wait がエラー番号' . $errno
+           . 'で失敗しました: ' . $message . PHP_EOL);
+}
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+pcntl_wait がエラー番号 10 で失敗しました: 子プロセスが存在しません
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>