cvs: phpdoc-de /reference/dir/functions class.dir.xml

From: Date: Tue, 20 Jan 2004 23:33:30 +0000
Subject: cvs: phpdoc-de /reference/dir/functions class.dir.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-1067@lists.php.net to get a copy of this message
conni Tue Jan 20 18:33:30 2004 EDT Modified files: /phpdoc-de/reference/dir/functions class.dir.xml Log: sync to en http://cvs.php.net/diff.php/phpdoc-de/reference/dir/functions/class.dir.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-de/reference/dir/functions/class.dir.xml diff -u phpdoc-de/reference/dir/functions/class.dir.xml:1.2 phpdoc-de/reference/dir/functions/class.dir.xml:1.3 --- phpdoc-de/reference/dir/functions/class.dir.xml:1.2 Sun Jun 9 06:55:35 2002 +++ phpdoc-de/reference/dir/functions/class.dir.xml Tue Jan 20 18:33:30 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./de/functions/dir.xml, last change in rev 1.2 --> <!-- last change to 'class.dir' in en/ tree in rev 1.2 --> <refentry id="class.dir"> @@ -18,39 +18,66 @@ <fieldsynopsis> <type>string</type><varname>path</varname> </fieldsynopsis> + <fieldsynopsis> + <type>resource</type><varname>handle</varname> + </fieldsynopsis> <methodsynopsis><type>string</type><methodname>read</methodname><void/></methodsynopsis> <methodsynopsis><type>void</type><methodname>rewind</methodname><void/></methodsynopsis> <methodsynopsis><type>void</type><methodname>close</methodname><void/></methodsynopsis> </classsynopsis> - <methodsynopsis> - <type>new</type><methodname>dir</methodname> - <methodparam><type>string</type><parameter>directory</parameter></methodparam> - </methodsynopsis> + <para> Ein Pseudo-Objekt-Orientierter Mechanismus zum Lesen eines Verzeichnisses. Das per <parameter>directory</parameter> angegebene Verzeichnis wird geöffnet. Sobald das Verzeichnis geöffnet ist, stehen 2 Eigenschaften zur Verfügung. Die - Eigenschaft Handle kann mit anderen Directory-Funktionen wie + Eigenschaft Handle kann mit anderen Verzeichnis-Funktionen wie <function>readdir</function>, <function>rewinddir</function> und <function>closedir</function> benutzt werden (Handles sind Verweise auf Einträge in einer internen Tabelle zur Verwaltung von Objekten). Die Eigenschaft Path enthält die Pfadangabe des geöffneten Verzeichnisses. Es sind 3 Methoden verfügbar: read, rewind und close. + </para> + <para> + Beachten Sie im nachfolgenden Beispiel, wie der Rückgabewert der + Funktion <function>dir</function> überprüft wird. Es wird explizit + getestet, ob der Rückgabewert identisch (den gleichen Wert und + Datentyp hat, siehe <link linkend="language.operators.comparison">) + mit &false; ist, weil sonst jeder Verzeichniseintrag, der + zu &false; ausgewertet wird, die Schleife abbricht. <example> <title><function>dir</function>-Beispiel:</title> <programlisting role="php"> +<![CDATA[ +<?php $d = dir("/etc"); echo "Handle: ".$d->handle."&lt;br&gt;\n"; echo "Path: ".$d->path."&lt;br&gt;\n"; -while($entry=$d-&gt;read()) { - echo $entry."&lt;br&gt;\n"; +while (false !== ($entry = $d->read())) { + echo $entry."<br />\n"; } $d->close(); +?> +]]> </programlisting> </example> </para> + <note> + <para> + Die Reihenfolge der Verzeichniseinträge, die von der + read-Methode zurückgegeben werden, ist systemabhängig. + </para> + </note> + <note> + <para> + Hierdurch wird die interne Klasse <classname>Directory</classname> + definiert, was bedeutet, dass Sie keine eigenen Klassen mit + diesem Namen definieren können. Eine vollständige Liste der + vordefinierten Klassen in PHP gibt es unter <link + linkend="reserved.classes">Vordefinierte Klassen</link>. + </para> + </note> </refsect1> </refentry>

« previous php.doc.de (#1067) next »