cvs: phpdoc-nl /reference/dir reference.xml /reference/dir/functions chdir.xml chroot.xml class.dir.xml closedir.xml getcwd.xml opendir.xml
readdir.xml rewinddir.xml
| From: | Sander Roobol | Date: | Sun, 26 May 2002 19:11:51 +0000 |
| Subject: | cvs: phpdoc-nl /reference/dir reference.xml /reference/dir/functions chdir.xml chroot.xml class.dir.xml closedir.xml getcwd.xml opendir.xml readdir.xml rewinddir.xml |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969345905@lists.php.net to get a copy of this message | ||
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>
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>