sander Sun May 26 15:11:51 2002 EDT
Modified files:
/phpdoc-nl/reference/dir reference.xml
/phpdoc-nl/reference/dir/functions chdir.xml chroot.xml
class.dir.xml closedir.xml
getcwd.xml opendir.xml
readdir.xml rewinddir.xml
Log:
Sync'ed with EN and added revision tags.
Index: phpdoc-nl/reference/dir/reference.xml
diff -u phpdoc-nl/reference/dir/reference.xml:1.2
phpdoc-nl/reference/dir/reference.xml:1.3
--- phpdoc-nl/reference/dir/reference.xml:1.2 Tue Apr 16 20:03:04 2002
+++ phpdoc-nl/reference/dir/reference.xml Sun May 26 15:11:50 2002
@@ -1,7 +1,54 @@
<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.3 Maintainer: sander Status: ready -->
<reference id="ref.dir">
<title>Directory functies</title>
<titleabbrev>Directories</titleabbrev>
+
+ <partintro>
+
+ <section id="dir.intro">
+ &reftitle.intro;
+ <para>
+ </para>
+ </section>
+
+ <section id="dir.requirenments">
+ &reftitle.required;
+ &no.requirement;
+ </section>
+
+ <section id="dir.installation">
+ &reftitle.install;
+ &no.install;
+ </section>
+
+ <section id="dir.configuration">
+ &reftitle.runtime;
+ &no.config;
+ </section>
+
+ <section id="dir.resources">
+ &reftitle.resources;
+ <para>
+ </para>
+ </section>
+
+ <section id="dir.constants">
+ &reftitle.constants;
+ &no.constants;
+ </section>
+
+ <section id="dir.seealso">
+ &reftitle.seealso;
+ <para>
+ Voor gerelateerde functies zoals <function>dirname</function>,
+ <function>is_dir</function>, <function>mkdir</function>, en
+ <function>rmdir</function>, zie de
+ <link linkend="ref.filesystem">Filesystem</link> sectie.
+ </para>
+ </section>
+
+ </partintro>
&reference.dir.functions;
Index: phpdoc-nl/reference/dir/functions/chdir.xml
diff -u phpdoc-nl/reference/dir/functions/chdir.xml:1.1
phpdoc-nl/reference/dir/functions/chdir.xml:1.2
--- phpdoc-nl/reference/dir/functions/chdir.xml:1.1 Sun Apr 14 21:37:09 2002
+++ phpdoc-nl/reference/dir/functions/chdir.xml Sun May 26 15:11:50 2002
@@ -1,10 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- splitted from ./nl/functions/dir.xml, last change in rev 1.1 -->
-<!-- last change to 'chdir' in en/ tree in rev 1.2 -->
+<!-- EN-Revision: 1.2 Maintainer: sander Status: ready -->
<refentry id="function.chdir">
<refnamediv>
<refname>chdir</refname>
- <refpurpose>verander de werk directory</refpurpose>
+ <refpurpose>verander de huidige directory</refpurpose>
</refnamediv>
<refsect1>
<title>Omschrijving</title>
@@ -15,7 +14,7 @@
<para>
Veranderd de huidige directory van PHP naar
<parameter>directory</parameter>. Geeft &false; terug als dit mislukt,
- of &true; als deze functie slaagt.
+ of &true; als dit wel lukt.
</para>
</refsect1>
</refentry>
Index: phpdoc-nl/reference/dir/functions/chroot.xml
diff -u phpdoc-nl/reference/dir/functions/chroot.xml:1.1
phpdoc-nl/reference/dir/functions/chroot.xml:1.2
--- phpdoc-nl/reference/dir/functions/chroot.xml:1.1 Sun Apr 14 21:37:09 2002
+++ phpdoc-nl/reference/dir/functions/chroot.xml Sun May 26 15:11:50 2002
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- splitted from ./nl/functions/dir.xml, last change in rev 1.2 -->
-<!-- last change to 'chroot' in en/ tree in rev 1.11 -->
+<!-- EN-Revision: 1.2 Maintainer: sander Status: ready -->
<refentry id="function.chroot">
<refnamediv>
<refname>chroot</refname>
@@ -15,8 +14,8 @@
<para>
Verandert de root directory van het huidige proces naar de directory
gespecificeerd door <parameter>directory</parameter>. De functie
- geeft &false; terug als hij er niet in slaagd de root directory aan te
- passen, als het goed gaat, geeft hij &true; terug.
+ geeft &false; terug als het niet lukt de root directory aan te
+ passen, en &true; als dat wel lukt.
</para>
<note>
<para>
Index: phpdoc-nl/reference/dir/functions/class.dir.xml
diff -u phpdoc-nl/reference/dir/functions/class.dir.xml:1.1
phpdoc-nl/reference/dir/functions/class.dir.xml:1.2
--- phpdoc-nl/reference/dir/functions/class.dir.xml:1.1 Sun Apr 14 21:37:09 2002
+++ phpdoc-nl/reference/dir/functions/class.dir.xml Sun May 26 15:11:50 2002
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- splitted from ./nl/functions/dir.xml, last change in rev 1.1 -->
-<!-- last change to 'class.dir' in en/ tree in rev 1.2 -->
+<!-- EN-Revision: 1.2 Maintainer: sander Status: ready -->
<refentry id="class.dir">
<refnamediv>
<refname>dir</refname>
@@ -21,19 +20,43 @@
<function>closedir</function> op los te laten. De path property
geeft de directory aan die is geopend. Drie methods zijn beschikbaar:
read, rewind and close.
+ </para>
+ <para>
+ Let erop op welke manier de return value van <function>dir</function>
+ wordt gecontroleerd. Je moet expliciet testen of de return value identiek
+ is aan (gelijk is en van hetzelfde type is -- zie <link
+ linkend="language.operators.comparison">Vergelijkings operators</link>
+ voor meer informatie) &false; omdat anders een directory entry dat
+ evalueert als &false; de loop zal stoppen.
<example>
<title><function>dir</function> Voorbeeld</title>
<programlisting role="php">
+<![CDATA[
$d = dir("/etc");
-echo "Handle: ".$d->handle."<br>\n";
-echo "Path: ".$d->path."<br>\n";
-while($entry=$d->read()) {
- echo $entry."<br>\n";
+echo "Handle: ".$d->handle."<br>\n";
+echo "Path: ".$d->path."<br>\n";
+while(false !== ($entry = $d->read())) {
+ echo $entry."<br>\n";
}
$d->close();
+]]>
</programlisting>
</example>
</para>
+ <note>
+ <para>
+ De volgorde waarin de items worden teruggegeven door read verschilt per
+ systeem.
+ </para>
+ </note>
+ <note>
+ <para>
+ Hier is de interne class <classname>Directory</classname> gedefinieerd,
+ en dat betekend dat het niet mogelijk is je eigen classes zo te noemen.
+ Voor een volledige lijst van gereserveerde classnamen zie <link
+ linkend="reserved.classes">Gereserveerde Classes</link>.
+ </para>
+ </note>
</refsect1>
</refentry>
Index: phpdoc-nl/reference/dir/functions/closedir.xml
diff -u phpdoc-nl/reference/dir/functions/closedir.xml:1.1
phpdoc-nl/reference/dir/functions/closedir.xml:1.2
--- phpdoc-nl/reference/dir/functions/closedir.xml:1.1 Sun Apr 14 21:37:09 2002
+++ phpdoc-nl/reference/dir/functions/closedir.xml Sun May 26 15:11:50 2002
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- splitted from ./nl/functions/dir.xml, last change in rev 1.1 -->
-<!-- last change to 'closedir' in en/ tree in rev 1.2 -->
+<!-- EN-Revision: 1.2 Maintainer: sander Status: ready -->
<refentry id="function.closedir">
<refnamediv>
<refname>closedir</refname>
Index: phpdoc-nl/reference/dir/functions/getcwd.xml
diff -u phpdoc-nl/reference/dir/functions/getcwd.xml:1.1
phpdoc-nl/reference/dir/functions/getcwd.xml:1.2
--- phpdoc-nl/reference/dir/functions/getcwd.xml:1.1 Sun Apr 14 21:37:09 2002
+++ phpdoc-nl/reference/dir/functions/getcwd.xml Sun May 26 15:11:50 2002
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- splitted from ./nl/functions/dir.xml, last change in rev 1.1 -->
-<!-- last change to 'getcwd' in en/ tree in rev 1.7 -->
+<!-- EN-Revision: 1.2 Maintainer: sander Status: ready -->
<refentry id="function.getcwd">
<refnamediv>
<refname>getcwd</refname>
Index: phpdoc-nl/reference/dir/functions/opendir.xml
diff -u phpdoc-nl/reference/dir/functions/opendir.xml:1.1
phpdoc-nl/reference/dir/functions/opendir.xml:1.2
--- phpdoc-nl/reference/dir/functions/opendir.xml:1.1 Sun Apr 14 21:37:09 2002
+++ phpdoc-nl/reference/dir/functions/opendir.xml Sun May 26 15:11:50 2002
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- splitted from ./nl/functions/dir.xml, last change in rev 1.1 -->
-<!-- last change to 'opendir' in en/ tree in rev 1.2 -->
+<!-- EN-Revision: 1.2 Maintainer: sander Status: ready -->
<refentry id="function.opendir">
<refnamediv>
<refname>opendir</refname>
@@ -18,6 +17,34 @@
<function>closedir</function>, <function>readdir</function>, en
<function>rewinddir</function> functies.
</para>
+ <para>
+ Als <parameter>path</parameter> geen bestaande directory is of als de
+ directory niet kan worden geopend vanwege permission restricties of
+ fouten in het bestandsysteem, zal <function>opendir</function> &false;
+ teruggeven en zal het een PHP error genereren. Je kan de output van de
+ error van <function>opendir</function> onderdrukken door een `@' voor de
+ functie naam te zetten.
+ </para>
+ <para>
+ <example>
+ <title><function>opendir</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+if ($dir = @opendir("/tmp")) {
+ while (($file = readdir($dir)) !== false) {
+ echo "$file\n";
+ }
+ closedir($dir);
+}
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>Zie ook <function>is_dir</function>.</para>
</refsect1>
</refentry>
Index: phpdoc-nl/reference/dir/functions/readdir.xml
diff -u phpdoc-nl/reference/dir/functions/readdir.xml:1.1
phpdoc-nl/reference/dir/functions/readdir.xml:1.2
--- phpdoc-nl/reference/dir/functions/readdir.xml:1.1 Sun Apr 14 21:37:10 2002
+++ phpdoc-nl/reference/dir/functions/readdir.xml Sun May 26 15:11:50 2002
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- splitted from ./nl/functions/dir.xml, last change in rev 1.1 -->
-<!-- last change to 'readdir' in en/ tree in rev 1.2 -->
+<!-- EN-Revision: 1.2 Maintainer: sander Status: ready -->
<refentry id="function.readdir">
<refnamediv>
<refname>readdir</refname>
@@ -14,20 +13,40 @@
</methodsynopsis>
<para>
Geeft de bestandsnaam van het volgende bestand in de directory. De
- bestandsnamen worden in een willekeurige volgorde teruggegeven.
+ bestandsnamen worden teruggegeven in de volgorde waarin ze zijn
+ opgeslagen in het bestandssysteem.
+ </para>
+ <para>
+ Let erop op welke manier de return value van <function>dir</function>
+ wordt gecontroleerd. Je moet expliciet testen of de return value identiek
+ is aan (gelijk is en van hetzelfde type is -- zie <link
+ linkend="language.operators.comparison">Vergelijkings operators</link>
+ voor meer informatie) &false; omdat anders een directory entry dat
+ evalueert als &false; de loop zal stoppen.
<example>
<title>Druk een lijst af van alle bestanden in de huidige directory</title>
<programlisting role="php">
-// Merk op dat !== niet bestond tot aan 4.0.0-RC2
-<?php
-$handle=opendir('.');
-echo "Directory handle: $handle\n";
-echo "Bestanden:\n";
-while (($file = readdir($handle))!==false) {
- echo "$file\n";
+<![CDATA[
+// Merk op dat !== niet bestond tot 4.0.0-RC2
+<?php
+if ($handle = opendir('/path/to/files')) {
+ echo "Directory handle: $handle\n";
+ echo "Files:\n";
+
+ /* Dit is de juiste manier om door een directory te wandelen. */
+ while (false !== ($file = readdir($handle))) {
+ echo "$file\n";
+ }
+
+ /* Dit is de VERKEERDE manier om door een directory te wandelen. */
+ while ($file = readdir($handle)) {
+ echo "$file\n";
+ }
+
+ closedir($handle);
}
-closedir($handle);
-?>
+?>
+]]>
</programlisting>
</example>
</para>
@@ -39,15 +58,17 @@
Druk alle bestanden behalve . en .. af in de huidige directory.
</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$handle=opendir('.');
while (false!==($file = readdir($handle))) {
- if ($file != "." && $file != "..") {
+ if ($file != "." && $file != "..") {
echo "$file\n";
}
}
closedir($handle);
-?>
+?>
+]]>
</programlisting>
</example>
</para>
Index: phpdoc-nl/reference/dir/functions/rewinddir.xml
diff -u phpdoc-nl/reference/dir/functions/rewinddir.xml:1.1
phpdoc-nl/reference/dir/functions/rewinddir.xml:1.2
--- phpdoc-nl/reference/dir/functions/rewinddir.xml:1.1 Sun Apr 14 21:37:10 2002
+++ phpdoc-nl/reference/dir/functions/rewinddir.xml Sun May 26 15:11:50 2002
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- splitted from ./nl/functions/dir.xml, last change in rev 1.1 -->
-<!-- last change to 'rewinddir' in en/ tree in rev 1.2 -->
+<!-- EN-Revision: 1.2 Maintainer: sander Status: ready -->
<refentry id="function.rewinddir">
<refnamediv>
<refname>rewinddir</refname>
