<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.dir">
  <title>Verzeichnis-Funktionen</title>
  <titleabbrev>Verzeichnisse</titleabbrev>
<!-- entspricht en/functions/dir.xml 1.9 -->

  <refentry id="function.chdir">
   <refnamediv>
    <refname>chdir</refname>
    <refpurpose>Wechseln des Verzeichnisses</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>chdir</methodname>
      <methodparam><type>string</type><parameter>directory</parameter></methodparam>
     </methodsynopsis>
    <para>
     Wechsel des aktuellen PHP-Verzeichnisses in das durch
     <parameter>directory</parameter> angegebene Verzeichnis. Gibt
     &false; zurck, wenn der Wechsel nicht mglich war, sonst &true;.
    </para>
   </refsect1>
  </refentry>

  <refentry id="class.dir">
   <refnamediv>
    <refname>dir</refname>
    <refpurpose>Verzeichnis-Klasse</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
    <classsynopsis>
     <ooclass><classname>dir</classname></ooclass>
     <constructorsynopsis>
      <methodname>dir</methodname>
      <methodparam><type>string</type><parameter>directory</parameter></methodparam>
     </constructorsynopsis>
     <fieldsynopsis>
      <type>string</type><varname>path</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 geffnet. Sobald das Verzeichnis
     geffnet ist, stehen 2 Eigenschaften zur Verfgung. Die
     Eigenschaft Handle kann mit anderen Directory-Funktionen wie
     <function>readdir</function>, <function>rewinddir</function>
     und <function>closedir</function> benutzt werden (Handles
     sind Verweise auf Eintrge in einer internen Tabelle zur
     Verwaltung von Objekten). Die Eigenschaft Path enthlt die
     Pfadangabe des geffneten Verzeichnisses. Es sind 3 Methoden
     verfgbar: read, rewind und close.
     <example>
      <title><function>dir</function>-Beispiel:</title>
      <programlisting role="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";
}
$d->close();
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.closedir">
   <refnamediv>
    <refname>closedir</refname>
    <refpurpose>Beenden eines Verzeichnis-Handles</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>closedir</methodname>
      <methodparam><type>int</type><parameter>dir_handle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Beendet den mit <parameter>dir_handle</parameter> angegebenen
     Verzeichnis-Stream (Ein-/Ausgabe-Kanal fr Verzeichnis-Objekte).
     Dieser muss vorher durch <function>opendir</function> geffnet
     worden sein.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.getcwd">
   <refnamediv>
    <refname>getcwd</refname>
    <refpurpose>Ermittelt das aktuelle Arbeitsverzeichnis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>getcwd</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Gibt das gegenwrtige Arbeitsverzeichnis zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.opendir">
   <refnamediv>
    <refname>opendir</refname>
    <refpurpose>ffnen eines Verzeichnis-Handles</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>opendir</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt ein Verzeichnis-Handle zurck, das in spteren Aufrufen von
     <function>closedir</function>, <function>readdir</function> und
     <function>rewinddir</function> gebraucht werden kann.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readdir">
   <refnamediv>
    <refname>readdir</refname>
    <refpurpose>Liest den Eintrag eines Verzeichnis-Handles</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>readdir</methodname>
      <methodparam><type>int</type><parameter>dir_handle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ermittelt den nchsten Dateinamen im Verzeichnis. Die Dateinamen
     werden ungeordnet zurck gegeben.
     <example>
      <title>Liste alle Dateien des aktuellen Verzeichnisses auf</title>
      <programlisting role="php">
&lt;?php
$handle=opendir ('.');
echo "Verzeichnis-Handle: $handle\n";
echo "Dateien:\n";
while (false !== ($file = readdir ($handle))) {
    echo "$file\n";
}
closedir($handle); 
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Beachten sie, dass <function>readdir</function> auch die Eintrge
     "." und ".." zurck gibt. Wollen sie das nicht, mssen sie diese
     ausschliessen:
     <example>
      <title>
       Liste alle Dateien des aktuellen Verzeichnisses unter Ausschluss
       von "." und ".." auf
      </title>	
      <programlisting role="php">
&lt;?php 
$handle=opendir('.'); 
while ($file = readdir ($handle)) { 
    if ($file != "." &amp;&amp; $file != "..") { 
        echo "$file\n"; 
    } 
}
closedir($handle); 
?&gt;
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rewinddir">
   <refnamediv>
    <refname>rewinddir</refname>
    <refpurpose>Zurcksetzen des Verzeichnis-Handles</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>void</type><methodname>rewinddir</methodname>
      <methodparam><type>int</type><parameter>dir_handle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt den mit <parameter>dir_handle</parameter> angegebenen
     Verzeichnis-Stream auf den Anfang zurck (Reset).
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->