reference/dir/functions/readdir.xml
b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3
b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3
...
...
@@ -10,8 +10,8 @@
10
10
<refsect1 role="description">
11
11
&reftitle.description;
12
12
<methodsynopsis>
13
-
<type>string</type><methodname>readdir</methodname>
14
-
<methodparam choice="opt"><type>resource</type><parameter>dir_handle</parameter></methodparam>
13
+
<type class="union"><type>string</type><type>false</type></type><methodname>readdir</methodname>
14
+
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>dir_handle</parameter><initializer>&null;</initializer></methodparam>
15
15
</methodsynopsis>
16
16
<para>
17
17
Returns the name of the next entry in the directory. The
...
...
@@ -47,6 +47,28 @@
47
47
&return.falseproblem;
48
48
</refsect1>
49
49
50
+
<refsect1 role="changelog">
51
+
&reftitle.changelog;
52
+
<informaltable>
53
+
<tgroup cols="2">
54
+
<thead>
55
+
<row>
56
+
<entry>&Version;</entry>
57
+
<entry>&Description;</entry>
58
+
</row>
59
+
</thead>
60
+
<tbody>
61
+
<row>
62
+
<entry>8.0.0</entry>
63
+
<entry>
64
+
<parameter>dir_handle</parameter> is now nullable.
65
+
</entry>
66
+
</row>
67
+
</tbody>
68
+
</tgroup>
69
+
</informaltable>
70
+
</refsect1>
71
+
50
72
<refsect1 role="examples">
51
73
&reftitle.examples;
52
74
<para>
...
...
@@ -56,8 +78,7 @@
56
78
Please note the fashion in which <function>readdir</function>'s
57
79
return value is checked in the examples below. We are explicitly
58
80
testing whether the return value is identical to (equal to and of
59
-
the same type as--see <link
60
-
linkend="language.operators.comparison">Comparison
81
+
the same type as--see <link linkend="language.operators.comparison">Comparison
61
82
Operators</link> for more information) &false; since otherwise,
62
83
any directory entry whose name evaluates to &false; will stop the
63
84
loop (e.g. a directory named "0").
...
...
@@ -123,7 +144,6 @@ if ($handle = opendir('.')) {
123
144
</para>
124
145
</refsect1>
125
146
</refentry>
126
-
127
147
<!-- Keep this comment at the end of the file
128
148
Local variables:
129
149
mode: sgml
130
150