com doc/ja: Improvements to stat() - document other file types: reference/filesystem/functions/stat.xml

[email protected] (Yoshinari Takaoka) Mon, 15 Feb 2021 22:31:24 +0000
Newsgroups php.doc.ja
Message-ID <[email protected]>
Commit:    8f828656539e28d63e5a5789a3dab0770d222d0a
Author:    Yoshinari Takaoka <[email protected]>         Tue, 16 Feb 2021 07:31:24 +0900
Parents:   2d22f0dd5e51569457accd17b917f4b1e64b08b3
Branches:  master

Link:       http://git.php.net/?p=doc/ja.git;a=commitdiff;h=8f828656539e28d63e5a5789a3dab0770d222d0a

Log:
Improvements to stat() - document other file types

Document character device and sockets

Link to SplFileInfo.
Unlike stat(), SplFileInfo throws instead of emitting a notice,
which is convenient for avoiding the error handler.
(file_exists() returns files that exist but are unreadable)

Related to GH-319

Closes GH-322.

Changed paths:
  M  reference/filesystem/functions/stat.xml


Diff:
diff --git a/reference/filesystem/functions/stat.xml b/reference/filesystem/functions/stat.xml
index 59e8e3f785..6e6e6aad8f 100644
--- a/reference/filesystem/functions/stat.xml
+++ b/reference/filesystem/functions/stat.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 8b7fb1d4ace11d6884bec2e160ab24e93716b9bf Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.stat" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -167,6 +167,10 @@
      </thead>
      <tbody>
       <row>
+       <entry><constant>0140000</constant></entry>
+       <entry>ソケット</entry>
+      </row>
+      <row>
        <entry><constant>0120000</constant></entry>
        <entry>リンク</entry>
       </row>
@@ -183,6 +187,10 @@
        <entry>ディレクトリ</entry>
       </row>
       <row>
+       <entry><constant>0020000</constant></entry>
+       <entry>キャラクタデバイス</entry>
+      </row>
+      <row>
        <entry><constant>0010000</constant></entry>
        <entry>fifo</entry>
       </row>
@@ -316,6 +324,7 @@ if (!$stat) {
     <member><function>fstat</function></member>
     <member><function>filemtime</function></member>
     <member><function>filegroup</function></member>
+    <member><classname>SplFileInfo</classname></member>
    </simplelist>
   </para>
  </refsect1>