svn: /phpdoc/ja/trunk/reference/filesystem/functions/ stat.xml

mumumu                                   Fri, 03 Jul 2020 12:26:01 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=350101

Log:
Document dev element of stat() array on Windows

Changed paths:
    U   phpdoc/ja/trunk/reference/filesystem/functions/stat.xml

Modified: phpdoc/ja/trunk/reference/filesystem/functions/stat.xml
===================================================================
--- phpdoc/ja/trunk/reference/filesystem/functions/stat.xml	2020-07-03 08:30:39 UTC (rev 350100)
+++ phpdoc/ja/trunk/reference/filesystem/functions/stat.xml	2020-07-03 12:26:01 UTC (rev 350101)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 348349 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 350100 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stat">
  <refnamediv>
@@ -61,7 +61,7 @@
       <row>
        <entry>0</entry>
        <entry>dev</entry>
-       <entry>デバイス番号</entry>
+       <entry>デバイス番号 (***)</entry>
       </row>
       <row>
        <entry>1</entry>
@@ -126,13 +126,21 @@
      </tbody>
     </tgroup>
    </table>
-   * Windows では常に 0 となります。
+   * Windows では常に <literal>0</literal> となります。
   </para>
   <para>
    ** st_blksize タイプをサポートするシステムでのみ有効です。
-   その他のシステム(例えば Windows)では -1 を返します。
+   その他のシステム(例えば Windows)では <literal>-1</literal> を返します。
   </para>
   <para>
+   *** PHP 7.4.0 以降、Windows では、この値はファイルを含んだボリュームのシリアル番号です。
+   これは32ビットの <emphasis>符号なし</emphasis> 整数です。
+   よって、32ビットシステムではオーバーフローする可能性があります。
+   これより前のバージョンでは、<function>stat</function> 関数ではドライブレターを数値で表現した値
+   (たとえば、<literal>C:</literal> では <literal>2</literal>) でした。
+   <function>lstat</function> 関数では <literal>0</literal> でした。
+  </para>
+  <para>
   <literal>mode</literal> の値は、複数の関数によって読まれる情報が含まれています。
   8進数の場合、一番右の桁から評価され、はじめの3桁が <function>chmod</function> によって返されます。
   次の桁は PHP によって無視されます。その次の2桁は以下のファイルタイプを示します:
@@ -185,6 +193,29 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>7.4.0</entry>
+      <entry>
+       Windows では、
+       デバイス番号は、ファイルが含まれるボリュームのシリアル番号を返すようになりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>