cvs: phpdoc-de /reference/dir/functions class.dir.xml
| From: | Cornelia Boenigk | 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."<br>\n";
echo "Path: ".$d->path."<br>\n";
-while($entry=$d->read()) {
- echo $entry."<br>\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>